cave-hunters-wallpaper

Add prehistoric cave-painting hunter silhouettes to any dark wallpaper.

Overlays cave art style figures — hunters with spears and bows, fleeing deer, handprints, and symbols — onto your wallpaper. Designed for dark backgrounds where the figures blend in subtly, priming you for the hunt (code, jobs, tasks, bugs...).

Prerequisites

• uv

That's it. No virtualenv or pip install needed — uv run handles dependencies automatically.

Usage

# Basic — creates <input>_hunters.png next to the original
uv run cave_hunters.py wallpaper.png

# Specify output path
uv run cave_hunters.py wallpaper.png -o result.png

# Adjust opacity (0-255, default: 90)
uv run cave_hunters.py wallpaper.png --alpha 60    # more subtle
uv run cave_hunters.py wallpaper.png --alpha 120   # more visible

# Change base color (R,G,B — default: 100,140,160 teal-blue)
uv run cave_hunters.py wallpaper.png --color "140,120,90"   # warm/earthy
uv run cave_hunters.py wallpaper.png --color "130,130,150"   # cool grey

# Different random seed for varied placement of dot trails
uv run cave_hunters.py wallpaper.png --seed 99

Options

Flag	Default	Description
input	(required)	Path to input wallpaper image
-o, --output	<input>_hunters.<ext>	Output file path
--alpha	90	Base opacity for figures (0-255)
--color	100,140,160	Base RGB color for figures
--seed	42	Random seed for reproducible dot trails

What it draws

• Hunters with spears — running pose, cave-painting stick figures
• Hunters with bows — aiming stance with drawn bowstring
• Deer — fleeing prey with antlers
• Handprints — classic cave art motif
• Dot trails — tracking paths between figures
• Symbols — sun circle, water zigzag

Figures are placed on both sides of the wallpaper, leaving the center clear for desktop icons or code editors.

Tips

• Works best on dark wallpapers — the figures are semi-transparent overlays
• The --color flag sets the base; 4 additional variants are auto-generated from it
• Match the color to your wallpaper's dominant hue for best blending
• Lower --alpha for subliminal/barely-visible figures, higher for prominent ones