How turgut-kalyon/sway-wallpi works
Wallpi is a terminal wallpaper browser. The main workflow loads configured wallpaper paths into a Vim-navigable list, previews the highlighted image, and on selection replaces a configured symlink and can reload the desktop wallpaper. The graph separates configuration, browsing, preview, and wallpaper application, with the Textual app as the workflow owner. Evidence comes from the supplied README and source excerpts; the README documents the user-facing capabilities, while some internal details were not sampled.
Main entry points: wallpi_app.py Textual app · link_wp.py Symlink manager · wallpaper_list.py Wallpaper listing · config_loader.py Config loader
Components 10
Configuration
- Config loader
src/app/core/config/config_loader.py
Wallpaper browsing
- Textual app
src/app/wallpi_app.py - Wallpaper listing
src/app/widgets/wallpaper_list.py - Vim list view
src/app/widgets/vim_list_view.py
Image preview
- Terminal image preview
src/app/wallpi_app.py - Preview loader
src/app/wallpi_app.py
Wallpaper setting
- Symlink manager
src/app/core/link/link_wp.py - Wallpaper backend
- Desktop notifications
Other components
- Terminal user
Connections 12
- Terminal user → Textual app: uses
README.md - Textual app → Config loader: reads settings
src/app/wallpi_app.py - Textual app → Wallpaper listing: loads wallpapers
src/app/wallpi_app.py - Wallpaper listing → Config loader: reads folder
src/app/widgets/wallpaper_list.py - Wallpaper listing → Vim list view: builds list
src/app/widgets/wallpaper_list.py - Textual app → Vim list view: handles selection
- Textual app → Preview loader: loads highlighted image
src/app/wallpi_app.py - Preview loader → Terminal image preview: sets preview
src/app/wallpi_app.py - Textual app → Symlink manager: sets selected wallpaper
src/app/wallpi_app.py - Symlink manager → Config loader: reads reload setting
src/app/core/link/link_wp.py - Symlink manager → Wallpaper backend: invokes available tool
src/app/core/link/link_wp.py - Symlink manager → Desktop notifications: reports outcome
src/app/core/link/link_wp.py