A Python application for scanning directories of wallpaper images and storing them in a database with automatic tagging based on folder structure and picking wallpapers based on rules. I.e. prefer images tagged with "rain" or "rainy" if it's currently raining.
- Recursively scans directories for wallpaper images
- Automatically tags images based on their folder path
- Stores image metadata (dimensions, file size, format) in SQLite database
- Weather-based wallpaper rules: Automatically select wallpapers based on current weather conditions
- Time-based and date-based wallpaper rules
Download the latest executable for your platform from the Releases page.
- Make sure you have Python 3.7+ installed
- Install dependencies:
pip install -r requirements.txt
Using the executable:
# Windows
hintergrund.exe scan "C:\path\to\wallpapers"
# Linux/macOS
./hintergrund scan "/path/to/wallpapers"Using Python:
python main.py scan "/path/to/wallpapers"This will:
- Recursively scan the specified directory
- Extract metadata from each image
- Tag images based on their folder structure
- Store everything in a SQLite database
Images are automatically tagged based on their folder structure. For example:
- Image at
/wallpapers/nature/forest/mountain/sunset.jpg - Gets tags:
nature,forest,mountain
The base scan directory is not included in tags.
Using the executable: Using the executable:
./hintergrund list --tags nature forest
python main.py list --tags nature forest- The GUI is ugly, did you know that? - Yes.
- Python is garbage, you know Rust is way better? - Yes.
- This code is bad, did an LLM write it? - Yes.
- This code is genius, did you write it? - Yes.