RandomWallpaperGnome3/README.md
2018-04-12 17:57:30 +02:00

39 lines
1.8 KiB
Markdown

RandomWallpaperGnome3
=====================
Random Wallpapers for Gnome 3 is a gnome shell extension which fetches a random wallpaper from an online source and sets it as desktop background.
![Screenshot](/assets/screenshot.png)
## Installation (symlink to repository)
Clone the repository and run `./install.sh` in the repository folder to make a symbolic link from the extensions folder to the git repository.
This installation will depend on the repository folder, so do not delete the cloned folder.
Then open the command prompt (Alt+F2) end enter `r` to restart the gnome session.
In the case you are using wayland, then no restart should be required.
Now you should be able to activate the extension through the gnome-tweak-tool.
__Installing this way has various advantages:__
* Switching between versions and branches.
* Updateing the extension with `git pull`
## Installation (manually)
Clone or download the repository and copy the folder `randomwallpaper@iflow.space` in the repository to `~/.local/share/gnome-shell/extensions/`.
Then open the command prompt (Alt+F2) end enter `r` to restart the gnome session.
In the case you are using wayland, then no restart should be required.
Now you should be able to activate the extension through the gnome-tweak-tool.
## Uninstall
Run `./install uninstall` to delete the symbolic link.
If you installed the extension manually you have to delete the extension folder `randomwallpaper@iflow.space` in `~/.local/share/gnome-shell/extensions/`.
## Debugging
Extension output can be followed with `./debug.sh`. Information should be printed using the existing logger class but can also be printed with `global.log()` (not recommended).
To debug the `prefs.js` use `./debug.sh perfs`.
## Compiling schemas
This can be done with the command: `glib-compile-schemas randomwallpaper@iflow.space/schemas/`