https://github.com/wieczorek1990/disper-menu

Disper Menu GNOME Shell extension
https://github.com/wieczorek1990/disper-menu

Last synced: 2 months ago
JSON representation

Disper Menu GNOME Shell extension

• Host: GitHub
• URL: https://github.com/wieczorek1990/disper-menu
• Owner: wieczorek1990
• License: gpl-2.0
• Created: 2014-10-13T18:42:52.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2022-07-22T17:37:05.000Z (over 2 years ago)
• Last Synced: 2024-04-13T08:09:32.473Z (10 months ago)
• Language: JavaScript
• Homepage: https://extensions.gnome.org/extension/884/disper-menu/
• Size: 119 KB
• Stars: 4
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Disper Menu

===========

![Disper Menu](images/disper-menu.png) ![Disper Menu preferences](images/disper-menu-preferences.png)

## About

Disper Menu is a GNOME Shell extension that allows you to use the on-the-fly display switcher `disper` through GNOME Shell panel.

Actions supported are: primary, secondary, clone, extend, cycle.

Disper Menu was only tested with GNOME Shell 3.14.0.

## Installation

You need to install `disper` from your Linux distribution software repository or from [disper homepage](http://willem.engen.nl/projects/disper/) in order to use this extension. E.g. for Ubuntu:

```

sudo apt-get update && sudo apt-get install -y disper

```

I recommend using [GNOME.org Extensions](https://extensions.gnome.org/extension/884/disper-menu/) for Disper Menu installation.

If your browser doesn't support NPAPI (e.g. Google Chrome) and you don't want to use another web browser to download GNOME Shell extensions, you can clone this repository using `git` and use the [install](scripts/install) script like this:

```shell

git clone https://github.com/wieczorek1990/disper-menu.git && ./disper-menu/scripts/install && rm -rf disper-menu

```

## Preferences

You can setup preferences using `gnome-shell-extension-prefs` or `gnome-tweak-tool`.

Available `disper` preferences are: scaling mode, extend direction.

For more `disper` preferences you should create a `disper` config file. See "FILES" section of the `disper` manual.

## Translation

Disper Menu is currently translated into English, German and Polish.

If you wish to see it in other language or have fixed any translation errors, send me a pull request with the `po` file.

You can generate the `pot` file using [create_pot](scripts/create_pot) script.

I recommend using [poedit](http://poedit.net/) for translations.

## Debugging

Press Alt + F2 and type lg to show the Looking Glass console.

Press Alt + F2 and type r to restart Gnome shell.

## Publishing

```

# sudo apt-get install gettext p7zip-full

# sudo dnf install p7zip-plugins

cd disper-menu/

./scripts/create_pot

./scripts/install

./scripts/package

```

## Availability

Please modify metadata.json `shell-version` attribute and check if it works for your Gnome shell. Then prepare a pull request. Thanks!

## Authors

Łukasz Wieczorek aka wieczorek1990

## Translation contributors

* German

    * Christian Zemsauer aka cri

* Dutch

    * Vistaus

## License

See the [GNU GPL v2.0 license](LICENSE).