How lucifer516-sudoer/awww-picker works
wp_pikr is a small terminal wallpaper picker for Hyprland/Caelestia. Its workflow loads image files from a configured directory, presents searchable names in a Textual interface, and applies the selected file through the Caelestia command. The runtime is implemented in one source file, so several components share its path. The README documents the directory configuration requirement; no separate storage or domain modules are present.
Main entry points: main.py Picker app
Components 11
Picker interface
- App entry
src/wp_pikr/main.py - Picker app
src/wp_pikr/main.py - Searchable list
src/wp_pikr/main.py - Wallpaper item
src/wp_pikr/main.py - Status log
src/wp_pikr/main.py
Wallpaper operations
- Wallpaper loader
src/wp_pikr/main.py - Name formatter
src/wp_pikr/main.py - Wallpaper apply
src/wp_pikr/main.py
Other components
- User
- Wallpaper directory
- Caelestia Shell
Connections 11
- User → App entry: starts
README.md - App entry → Picker app: runs
src/wp_pikr/main.py - Picker app → Wallpaper loader: loads files
src/wp_pikr/main.py - Wallpaper loader → Wallpaper directory: reads images
src/wp_pikr/main.py - Picker app → Searchable list: renders
src/wp_pikr/main.py - Searchable list → Name formatter: formats names
src/wp_pikr/main.py - Searchable list → Wallpaper item: creates items
src/wp_pikr/main.py - User → Searchable list: filters or selects
src/wp_pikr/main.py - Picker app → Wallpaper apply: applies selection
src/wp_pikr/main.py - Wallpaper apply → Caelestia Shell: sets wallpaper
src/wp_pikr/main.py - Picker app → Status log: writes status
src/wp_pikr/main.py