Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/BigE/desk-changer

Gnome-Shell wallpaper changing extension with multiple profile support
https://github.com/BigE/desk-changer

gnome-shell-extension wallpaper

Last synced: 3 months ago
JSON representation

Gnome-Shell wallpaper changing extension with multiple profile support

Awesome Lists containing this project

README

        

# DeskChanger

DeskChanger is a gnome-shell wallpaper slideshow extension with multiple
profile support. The extension allows you to switch profiles on the fly
without reloading the daemon.

## Screenshots


## Requirements

The requirements are for the most recent version of the plugin. Previous
versions support older versions of gnome-shell.

* gnome-shell 3.32 or higher
* gjs 1.54 or higher

## Install

First clone the repo and run the following install instructions.

```
git clone -b develop [email protected]:BigE/desk-changer.git
cd desk-changer
make all
```

Once the make process is complete, you can then run `make install` to install
the extension to your local directory. If you want to install it to the
system, just copy the desk-changer@eric.gach.gmail.com folder to your
`/usr/share/gnome-shell/extensions/` folder.

>\# cp -r [email protected]/ /usr/share/gnome-shell/extensions/

Then restart gnome-shell and enable the extension. Once it is enabled, you can
use the extension to start the daemon with the built in toggle switch.

## General Information
### Daemon

The daemon is now part of the extension itself and has no command line
interface. The only interface available to the daemon now is the DBus
interface.

#### DBUS Interface
**Name**: `org.gnome.Shell.Extensions.DeskChanger.Daemon`

**Path**: `/org/gnome/Shell/Extensions/DeskChanger/Daemon`

##### Methods
* `Load(String profile)` Loads the specified profile and respective locations
* `Next()` Switches to the next wallpaper, returns the uri
* `Prev()` Switches to the previous wallpaper, returns the uri
* `Quit()` Terminates the daemon process.
* `Start()` Enables automatic rotation and makes the daemon available
* `Stop([Boolean quit])` Disables automatic rotation and makes the daemon
unavaialble for use. If `quit` is `true` then the daemon process will be
terminated.

##### Properties
* History - Read only array of history
* Preview - Read only URI of the next wallpaper
* Queue - Read only array of the queue
* Running - Read only boolean value if the daemon is stopped or started

##### Signals
* Changed - Emitted when the wallpaper is changed, uri to wallpaper file
* Preview - Emitted when a new preview is available, uri to preview file
* Running - Emitted when the daemon is stopped and started

### dconf-editor

To view the settings in dconf-editor, just use the `GSETTINGS_SCHEMA_DIR=`
environment variable to open dconf-editor with the extensions schema available
to the editor.

>$ GSETTINGS_SCHEMA_DIR=~/.local/share/gnome-shell/extensions/[email protected]/schemas/ dconf-editor /org/gnome/shell/extensions/desk-changer

Then navigate to `/org/gnome/shell/extensions/desk-changer` and you will see
all of the available settings for the extension and daemon.