Turn your command line into a Matrix‑style rain of 0s and 1s — which periodically assembles into a random Pokémon sprite (colours and all), holds for a few seconds, then dissolves back into the downpour.

Just a fun piece of terminal eye‑candy to run in a spare window.

• Fetches a random Pokémon sprite from pkmn.li via ANSI art. Currently fetches Gen 3 National Dex only and also for the forseeable future :) Nothing beats Gen 3 and you cannot change my mind!
• Parses the coloured blocks into 1s (bright) and 0s (dim), using the exact 256‑color codes.
• Displays the sprite as falling digits that “assemble” into it.
• Holds the completed sprite for a few seconds, then dissolves it back into rain.
• Repeats with a new Pokémon — and the next one is pre‑loaded in the background, so you never wait.

• Ambient background for a tmux pane, a terminal tab, or a Raspberry Pi on a spare monitor.
• Focus break — glance at it for a mental reset during long coding sessions.
• Just for fun — because why not?

# On Linux/macOS/WSL – Python’s curses is built‑in
pip install requests
python3 drizzle.py

# On Windows – install windows-curses first
pip install windows-curses
pip install requests
python drizzle.py

Examples:

# Random Pokémon each cycle (default)
python3 drizzle.py

# Old fade‑in‑place disintegration
python3 drizzle.py --spot-disappear

# Cycle through your favourite Pokémon
python3 drizzle.py --pokemon pikachu,eevee,ditto

# Combine both
python3 drizzle.py --pokemon bulbasaur,ivysaur,venusaur --spot-disappear

• A background thread continuously fetches sprites.
• The main loop runs the rain physics and a state machine: rain → assembling → holding → disintegrating → rain ...
• Rain takes on the dominant colour of the current sprite (using a fixed set of 3 pairs, so no pair‑leak).

• Written in pure Python, using curses and the requests library (for fast, persistent HTTP connections).
• Requires a terminal that supports at least 256 colours (falls back to a 6‑colour palette if not).
• Resizes gracefully when you change the window size.

Install requests with:

• Pokémon sprites from pkmn.li – an awesome ANSI‑art API.
• Inspired by the classic Matrix digital rain effect.

MIT — use it, break it, improve it.

Enjoy the rain! 🌧️✨