pokemon-a-day-wallpaper 0.1.0

Sets a daily Pokémon fan art wallpaper on Ubuntu GNOME

pokemon-a-day-wallpaper

A CLI tool that automatically sets a new Pokémon fan art wallpaper on your Ubuntu GNOME desktop every day.

Every day a Pokémon is randomly selected (seeded by the date, so it's consistent throughout the day) and a high-quality fan art wallpaper (1920x1080 or higher) is fetched from Wallhaven and applied to your desktop. If you don't like the wallpaper, just run next to get a different one — it will still change automatically the following day.

Requirements

• Ubuntu with GNOME desktop
• Python 3.10+
• Internet connection

Installation

pip install pokemon-a-day-wallpaper

Usage

Apply today's wallpaper immediately

pokemon-wallpaper run

Skip to a different wallpaper (same day)

Don't like today's pick? Get the next one:

pokemon-wallpaper next

You can run next as many times as you want throughout the day. The wallpaper will still automatically reset to a fresh Pokémon the following day.

Schedule daily automatic updates

Installs a systemd user timer that runs every day at 08:00:

pokemon-wallpaper install

After installing the timer, apply today's wallpaper right away:

pokemon-wallpaper run

Remove the automatic schedule

pokemon-wallpaper uninstall

How it works

1. Pokémon selection — A random Pokémon is chosen each day using the date as a seed, making the selection deterministic (the same Pokémon all day, a new one each day).
2. Wallpaper search — The Wallhaven API is queried for fan art of that Pokémon at 1920x1080 or higher, sorted by community favorites.
3. Fallback — If no wallpaper is found for the selected Pokémon, the next one in the day's sequence is tried automatically.
4. Download — The chosen image is saved to ~/.local/share/pokemon-wallpaper/.
5. Application — The wallpaper is set via gsettings, applying to both light and dark GNOME themes.

Wallpaper storage

Downloaded wallpapers are cached at:

~/.local/share/pokemon-wallpaper/

License

MIT