pokemon-a-day-wallpaper 1.1.0

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

Pokémon-a-day Wallpaper

As a big fan of Bing Wallpaper, I wanted something similar for my desktop but featuring Pokémon fanart. So I built this tool to automatically set a new Pokémon wallpaper every day, sourced from the amazing community on Wallhaven.

Pokémon-a-day Wallpaper is a CLI tool that randomly selects a Pokémon (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

• Windows 10/11 or Ubuntu with GNOME
• 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

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.

Go back to a previous wallpaper

pokemon-wallpaper previous

Navigates back through your wallpaper history. The session is paused while browsing — run refresh to return to today's wallpaper.

Resume today's wallpaper

pokemon-wallpaper refresh

Schedule daily automatic updates

Sets up the wallpaper to update every day at 08:00 and to apply automatically on login:

pokemon-wallpaper install

On Linux, this installs a systemd user timer and an XDG autostart entry.
On Windows, this creates a Task Scheduler entry and a registry Run key — no admin rights required.

After installing, apply today's wallpaper right away:

pokemon-wallpaper run

Remove the automatic schedule

pokemon-wallpaper uninstall

Browse your wallpaper history

pokemon-wallpaper list-wallpapers

Open the wallpaper folder

pokemon-wallpaper open-folder

Opens the folder where wallpapers are downloaded in your file manager.

Configure storage settings

pokemon-wallpaper config

Shows the current storage mode. Use flags to change it:

pokemon-wallpaper config --keep-images     # Save all wallpapers locally
pokemon-wallpaper config --no-keep-images  # Keep only the 3 most recent on disk

On first run you will be prompted interactively to choose a storage mode.

Wallpaper storage

Downloaded wallpapers and history are cached at:

Platform	Path
Linux	~/.local/share/pokemon-wallpaper/
Windows	%LOCALAPPDATA%\pokemon-wallpaper\

You can choose to keep all wallpapers locally or use a rolling cache that retains only the 3 most recent files on disk (history is always preserved).

License

MIT

Author

Marcos Filipe Capella - I'm a Software Engineer and Pokémon enthusiast. I created this project for my work laptop with the help of Claude Code and further refining it by myself.