How lostxxi/nekowall works
NekoWall is a desktop wallpaper manager for KDE Plasma and MATE. Users browse or import images and videos, choose a display, and apply a wallpaper through the GUI or terminal; the quick selector and multi-monitor controls are part of that workflow. The Rust CLI connects the Qt/QML interface to the library, orchestration service, and desktop-specific backends. The README also documents automatic folder updates, thumbnails, video handling, and playback power-saving. Some QML and Rust implementation details were not sampled, so those relationships are included only where documentation or excerpts support them.
Main entry points: main.rs CLI commands · src/lib.rs Wallpaper service · Bridge.cpp UI bridge · src/lib.rs MATE backend
Components 16
Desktop interface
- GUI entry
app/src/main.cpp - UI bridge
app/src/Bridge.cpp - Wallpaper library
app/qml/LibraryPage.qml - Quick selector
app/qml/Hud.qml - Settings
app/qml/SettingsPage.qml
Wallpaper workflow
- CLI commands
crates/nekowall-cli/src/main.rs - Wallpaper service
crates/nekowall-core/src/lib.rs - Backend contract
crates/nekowall-backend/src/lib.rs
Library and media
- Library index
crates/nekowall-library/src/lib.rs - SQLite catalog
crates/nekowall-library/src/lib.rs - Video analysis
crates/nekowall-cli/src/media.rs
Desktop backends
- Plasma backend
crates/nekowall-plasma/src/lib.rs - MATE backend
crates/nekowall-mate/src/lib.rs - MATE video playback
crates/nekowall-mate/src/video.rs - Desktop services
Other components
- User
Connections 20
- User → GUI entry: opens
README.md - User → CLI commands: runs commands
README.md - GUI entry → UI bridge: creates
app/src/main.cpp - UI bridge → CLI commands: invokes asynchronously
- Wallpaper library → UI bridge: browses and applies
README.md - Quick selector → UI bridge: selects wallpaper
README.md - Settings → UI bridge: configures
- CLI commands → Wallpaper service: orchestrates
crates/nekowall-cli/src/main.rs - CLI commands → Library index: queries and updates
crates/nekowall-cli/src/main.rs - CLI commands → Video analysis: probes and converts
crates/nekowall-cli/src/main.rs - CLI commands → MATE video playback: dispatches playback commands
crates/nekowall-cli/src/main.rs - Wallpaper service → Library index: reads and imports
crates/nekowall-core/src/lib.rs - Wallpaper service → Backend contract: applies through
crates/nekowall-core/src/lib.rs - Library index → SQLite catalog: stores catalog state
crates/nekowall-library/src/lib.rs - Wallpaper service → Plasma backend: uses when detected
- Wallpaper service → MATE backend: uses when detected
- MATE backend → MATE video playback: manages video playback
crates/nekowall-mate/src/lib.rs - Plasma backend → Desktop services: controls wallpapers
README.md - MATE backend → Desktop services: sets desktop backgrounds
README.md - MATE video playback → Desktop services: runs mpv via xwinwrap
crates/nekowall-mate/src/video.rs