random-wallpaper-gnome/README.md

23 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2025-02-04 01:51:58 +07:00
# Random Wallpaper for GNOME
2025-02-03 18:10:40 +00:00
2025-02-04 01:51:58 +07:00
A Python script to pick a random photo from the specified directory, set the wallpaper (for both light and dark) and the accent color.
## Why does this exist
We'd like to change our wallpaper every 15 minutes and automatically set a pre-defined accent color for each photo. There are many GNOME Shell extensions out there that can do something similar, but we simply want to achieve the same effect **without using any extensions**, especially when upgrading to a pre-release GNOME version that many extensions don't support yet.
So instead of a GNOME Shell extension, we created a Python script that does everything via `gsettings` and hook it up to a systemd timer instead.
## How to use
1. Create a directory with desired photos and note its full path
2. In that directory, append color codes to the files such as from `example.jpg` to `example-blue.jpg`. Possible color codes are `blue`, `teal`, `green`, `yellow`, `orange`, `red`, `pink` and `purple`. If other colors are set or there is no color code at all, we'll set the color to neutral `slate`.
3. Put `change-wallpaper.py` to `~/.local/bin` and make sure it is in your `$PATH`
4. In `change-wallpaper.service` replace `/path/to/dir` accordingly.
5. **Optionally**, modify `change-wallpaper.timer` as needed. The default is set to *every 15 minutes*.
6. Put `change-wallpaper.service` and `change-wallpaper.timer` in `~/.config/systemd/user/` and run these commands to get started
2025-02-04 01:51:58 +07:00
```
$ systemctl --user daemon-reload
$ systemctl --user enable --now change-wallpaper
```