RandomWallpaperGnome3/README.md

64 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2014-08-20 00:22:08 +00:00
RandomWallpaperGnome3
=====================
2018-11-01 23:41:16 +00:00
Random Wallpapers for Gnome 3 is a gnome-shell extension that fetches a random wallpaper from an online source and sets it as desktop background.
2018-11-02 22:33:17 +00:00
Install and try the extension at [extensions.gnome.org](https://extensions.gnome.org/extension/1040/random-wallpaper/).
2017-07-22 19:05:09 +00:00
![Screenshot](/assets/screenshot.png)
2018-11-01 23:41:16 +00:00
## Features
* Many different online sources with filters
* Unsplash (https://unsplash.com/)
* Desktoppr (https://desktoppr.co/)
* Wallhaven (https://alpha.wallhaven.cc/)
* Reddit (https://reddit.com)
* Basically any JSON API/File ([Examples](https://github.com/ifl0w/RandomWallpaperGnome3/wiki/Generic-JSON-Source))
* Chromecast Images
* NASA Picture of the day
* Bing Picture of the day
* Google Earth View
* History of previous images
* Set lock screen image
* Automatic renewal (Auto-Fetching)
## Installation (symlink to the repository)
2018-04-12 15:57:30 +00:00
Clone the repository and run `./install.sh` in the repository folder to make a symbolic link from the extensions folder to the git repository.
2017-07-22 18:55:39 +00:00
This installation will depend on the repository folder, so do not delete the cloned folder.
2018-04-12 15:57:30 +00:00
Then open the command prompt (Alt+F2) end enter `r` to restart the gnome session.
2018-11-01 23:41:16 +00:00
In the case you are using Wayland, then no restart should be required.
2018-04-12 15:57:30 +00:00
Now you should be able to activate the extension through the gnome-tweak-tool.
2017-07-22 18:55:39 +00:00
__Installing this way has various advantages:__
* Switching between versions and branches.
2018-11-01 23:41:16 +00:00
* Updating the extension with `git pull`
2017-07-22 18:55:39 +00:00
## Installation (manually)
2018-04-12 15:57:30 +00:00
Clone or download the repository and copy the folder `randomwallpaper@iflow.space` in the repository to `~/.local/share/gnome-shell/extensions/`.
2018-04-12 15:57:30 +00:00
Then open the command prompt (Alt+F2) end enter `r` to restart the gnome session.
2018-11-01 23:41:16 +00:00
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.
2017-02-04 23:48:52 +00:00
2017-07-22 18:55:39 +00:00
## Uninstall
Run `./install uninstall` to delete the symbolic link.
2018-04-12 15:57:30 +00:00
If you installed the extension manually you have to delete the extension folder `randomwallpaper@iflow.space` in `~/.local/share/gnome-shell/extensions/`.
2017-07-22 18:55:39 +00:00
2017-07-22 20:15:27 +00:00
## Debugging
2018-11-01 23:41:16 +00:00
You can follow the output of the extension with `./debug.sh`. Information should be printed using the existing logger class but can also be printed with `global.log()` (not recommended).
2018-04-12 15:57:30 +00:00
To debug the `prefs.js` use `./debug.sh perfs`.
2017-02-04 23:48:52 +00:00
## Compiling schemas
2017-07-22 20:15:27 +00:00
This can be done with the command: `glib-compile-schemas randomwallpaper@iflow.space/schemas/`
2018-11-01 23:41:16 +00:00
## Support Me
If you enjoy this extension and want to support the development, then feel free to buy me a coffee. :wink: :coffee:
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RBLX73X4DPS7A)