Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mboljen/backslide
Change the current desktop wallpaper
https://github.com/mboljen/backslide
bash-script desktop-environment gnome mate-desktop wallpaper-changer xfce4
Last synced: about 1 month ago
JSON representation
Change the current desktop wallpaper
- Host: GitHub
- URL: https://github.com/mboljen/backslide
- Owner: mboljen
- License: mit
- Created: 2021-01-24T14:05:41.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-06-23T22:57:59.000Z (6 months ago)
- Last Synced: 2024-06-24T01:59:03.522Z (6 months ago)
- Topics: bash-script, desktop-environment, gnome, mate-desktop, wallpaper-changer, xfce4
- Language: Shell
- Homepage:
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# backslide
Change the current desktop wallpaper with a selection from the given path
## Synopsis
```console
$ backslide [OPTION]... PATH...
```
## Description
This script parses the folder `path` for image files and changes the current wallpaper. Currently, only JPEG and PNG files are supported. From the list of wallpapers found and the current wallpaper, **backslide** will automatically select the next wallpaper in the list. If option **-r** is enabled, a random wallpaper is selected. If option **-l** is enabled, the wallpaper with the latest timestamp is selected.
## Options
+ `-d` _environment_
Force setting of wallpaper for specified desktop environment. If the user has an X session running, the value will be detected automatically. If **backslide** is invoked via a cronjob, this setting is mandatory. The following settings are supported: `gnome`, `mate`, and `xfce`.
+ `-R`
Recurse into subfolders when parsing `path` for PNG and JPEG files
+ `-r`
Select a random image file from the list of wallpapers
+ `-l`
Select the latest file from the list of wallpapers
+ `-h`
Show this help message
## Installation
Clone the remote repository and change into the local repository:
```console
$ git clone https://github.com/mboljen/backslide
$ cd backslide
```
Use the following command to install this software:
```console
$ make
$ make install
```
The default `PREFIX` is set to `/usr/local`. In order to successfully complete the installation, you need to have write permissions for the installation location.
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[MIT](https://choosealicense.com/licenses/mit/)