How goat095/macground works
Macground is a macOS wallpaper application for video and animated GIFs. The principal workflow takes a media file or folder through CLI selection, then applies it to the desktop, lock screen, or both. Desktop playback includes playlist rotation, native menu controls, and power-aware pausing; the lock-screen path converts media for macOS Aerial slots and updates system wallpaper state. The single 90 KB source file is only partially excerpted, so relationships for documented features are cited to the README rather than treated as inspected implementation details.
Main entry points: Macground.py CLI workflow
Components 17
Entry and Media
- CLI workflow
Macground.py - Media selection
Macground.py - Playlist rotation
Macground.py
Desktop Playback
- Desktop player
Macground.py - Menu bar controls
Macground.py - Power-aware pausing
Macground.py - Loop and speed
Macground.py
Lock Screen
- 4K media conversion
Macground.py - Aerial slot setup
Macground.py - Lock-screen apply
Macground.py - Backup and restore
Macground.py
App Management
- Standalone app bundle
Macground.py - Login startup
Macground.py
Other components
- User
- macOS desktop
- macOS wallpaper state
- LaunchAgent
Connections 17
- User → CLI workflow: selects media
README.md - CLI workflow → Media selection: selects input
README.md - Media selection → Playlist rotation: provides files
README.md - Playlist rotation → Desktop player: rotates wallpapers
README.md - CLI workflow → Desktop player: starts playback
README.md - Desktop player → macOS desktop: displays wallpaper
README.md - Menu bar controls → Desktop player: controls playback
README.md - Power-aware pausing → Desktop player: pauses playback
README.md - Loop and speed → Desktop player: sets playback
README.md - CLI workflow → 4K media conversion: starts conversion
README.md - 4K media conversion → Aerial slot setup: creates media
README.md - Aerial slot setup → Lock-screen apply: configures slots
README.md - Lock-screen apply → macOS wallpaper state: updates state
README.md - Backup and restore → macOS wallpaper state: restores state
README.md - CLI workflow → Standalone app bundle: builds or installs
README.md - CLI workflow → Login startup: configures startup
README.md - Login startup → LaunchAgent: creates or removes
README.md