Metadata-Version: 2.4
Name: pokemon-a-day-wallpaper
Version: 0.1.0
Summary: Sets a daily Pokémon fan art wallpaper on Ubuntu GNOME
Home-page: https://github.com/marcos-capella/pokemon-a-day-wallpaper
Author: Marcos Capella
Author-email: marcosfilipe.gc@gmail.com
License: MIT
Keywords: pokemon,wallpaper,gnome,ubuntu,automation
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Classifier: Topic :: Desktop Environment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: click>=8.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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](https://wallhaven.cc) 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

```bash
pip install pokemon-a-day-wallpaper
```

## Usage

### Apply today's wallpaper immediately

```bash
pokemon-wallpaper run
```

### Skip to a different wallpaper (same day)

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

```bash
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:

```bash
pokemon-wallpaper install
```

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

```bash
pokemon-wallpaper run
```

### Remove the automatic schedule

```bash
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](https://wallhaven.cc/help/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
