https://github.com/xbc5/wallpaper-randomiser
Randomise wallpapers on Linux, with a simple bash script and systemd.
https://github.com/xbc5/wallpaper-randomiser
bash bash-script bash-scripts feh linux linux-desktop python python-app python-script python3 simple systemd systemd-service wallpaper wallpaper-app wallpaper-changer wallpaper-rotator wallpapers
Last synced: about 1 month ago
JSON representation
Randomise wallpapers on Linux, with a simple bash script and systemd.
- Host: GitHub
- URL: https://github.com/xbc5/wallpaper-randomiser
- Owner: xbc5
- License: gpl-3.0
- Created: 2024-04-24T06:13:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-24T06:47:44.000Z (over 1 year ago)
- Last Synced: 2025-03-12T08:24:35.924Z (7 months ago)
- Topics: bash, bash-script, bash-scripts, feh, linux, linux-desktop, python, python-app, python-script, python3, simple, systemd, systemd-service, wallpaper, wallpaper-app, wallpaper-changer, wallpaper-rotator, wallpapers
- Language: Shell
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wallpaper Randomiser
## Description
Select a random wallpaper, from the local file system, every N minutes.
It will cycle through all images randomly in sequence -- so no images are left unused for long periods.
## Native Dependencies
`feh`, `notify-send`.
## Install
```sh
./install.sh i
```
This will enable the `wallpaper-randomiser.service` too, as a user service.
Also install native deps (choose one):
```sh
sudo apk add feh libnotify
sudo apt-get install feh libnotify-bin
sudo brew install feh libnotify
sudo dnf install feh libnotify
sudo pacman -S feh libnotify
sudo yum install feh libnotify
```
## Usage
Simply place jpg or png files in the `wallpaper_dir`, which defaults to `~/.wallpapers`.
## Config
The config file lives at `/etc/wallpaper-randomiser.yaml`, and the (implicit) default values are:
```yaml
interval_mins: 30
wallpaper_dir: ~/.wallpapers
```
## Uninstall
```sh
./install.sh u
```