Beautiful year calendar wallpapers for macOS showing your progress through the year.
- β¨ Modern design with clean aesthetics
- π― Multiple display modes: Day (365 dots), Week (52 dots), or Month (12 dots)
- 𧩠Multiple layout presets: centered, split-left, split-right, bottom-band, top-band
- π¨ Fully customizable colors and appearance
- π Curated built-in themes: dark, light, ocean, forest, sunset, mono, linen, pastel, bloom, candy, cream
- π Visual progress tracking with color-coded past/current/future periods
- π Automatic daily updates via LaunchAgent
- π₯οΈ 5K resolution (Γγ°γ€2880) optimized for macOS Retina displays
git clone https://github.com/madanlalit/progress.git cd progress pip install -e .
# Day mode (default) progress generate # Split layout with metadata progress generate --layout split-left --show-metadata # Right split layout progress generate --layout split-right # Band layouts progress generate --layout bottom-band progress generate --layout top-band # Day mode with 365 dots progress generate --mode day # Month mode progress generate --mode month # Sunset theme progress generate --theme sunset # Extra light background themes progress generate --theme linen progress generate --theme cream # Custom output location progress generate --output ~/Desktop/calendar.png # Custom colors progress generate --bg-color "#1a1a1c" --current-color "#ff7350" # Custom future color opacity progress generate --theme ocean --future-color "#7AE5FF33"
# Install LaunchAgent for daily updates at midnight progress install # Uninstall progress uninstall
usage: progress [-h] [--version] {generate,install,uninstall} ...
Commands:
generate Generate wallpaper
install Install daily auto-update
uninstall Uninstall daily auto-update
Generate options:
--mode {day,week,month} Display mode (default: day)
--theme THEME Theme: dark/light/ocean/forest/sunset/mono/linen/pastel/bloom/candy/cream
--layout {centered,split-left,split-right,bottom-band,top-band}
Layout preset (default: centered)
--output PATH Output file path
--bg-color HEX Background color (e.g., "#1a1a1c")
--past-color HEX Past periods color
--current-color HEX Current period color
--future-color HEX Future periods color (#RRGGBB or #RRGGBBAA)
--dot-size INT Override dot size
--show-metadata Show weekday/week/remaining metadata line
--no-set Generate only, don't set as wallpaper
52 dots representing each week of the year in a single row.
365 dots representing every day of the year in 5 rows - perfect for daily tracking!
12 large dots representing each month - for a cleaner, simpler view.
- centered: Original balanced vertical stack
- split-left: Text column on the left, grid on the right
- split-right: Grid on the left, text on the right
- bottom-band: Header at top, grid in lower middle, progress line near bottom
- top-band: Grid in upper middle, text below, progress line near bottom
All display modes feature:
- Past periods: Subtle gray dots
- Current period: Bright coral dot
- Future periods: Semi-transparent theme-matched dots
- Theme rendering: Theme-aware vignette, glow, and texture controls
- Light theme variety: Multiple bright palettes for daytime desktops
- Display: Year, current date, progress info, and completion percentage
- macOS
- Python >=3.8
- Pillow >=9.0.0
# Clone repository git clone https://github.com/madanlalit/progress.git cd progress # Install in development mode pip install -e . # Run locally python -m progress.cli generate
MIT License - see LICENSE file for details
Contributions are welcome! Please feel free to submit a Pull Request.
Created by Lalit Madan
Made with β€οΈ for tracking your year's progress