How machad3x/way-vibrance works
Way Vibrance is a KDE Plasma 6 KWin desktop effect for global saturation and RGB gains, with per-window app profiles controlled through a tray UI or CLI. The main flow is user control → D-Bus settings → compositor-side window matching and color grading; settings persist across sessions. The README documents CLI, hotkeys, presets, monitor selection, and update checking. Source excerpts show D-Bus registration, asynchronous tray calls, profile matching, shader handling, and configuration persistence; unsampled CLI wiring is left unverified.
Main entry points: vibranceeffect.cpp Window color grading · main.cpp Tray UI · vibranceeffect.h D-Bus API · wayvibrance CLI controls
Components 19
User controls
- Tray UI
tray/main.cpp - Profile editor
tray/main.cpp - CLI controls
cli/wayvibrance - UI widgets
tray/resetbutton_p.h - Theme styling
tray/style_p.h - D-Bus trust check
tray/dbus_security_p.h
Compositor effect
- Effect plugin
effect/main.cpp - Window color grading
effect/vibranceeffect.cpp - RGB shader
effect/shaders/wayvibrance.frag
Profiles and matching
- App profiles
effect/vibranceeffect.cpp - Glob matching
effect/globmatch_p.h
Settings and integrations
- D-Bus API
effect/vibranceeffect.h - Persistent settings
effect/vibranceeffect.cpp - Shared limits
common_limits.h - Update check
tray/main.cpp
Other components
- Desktop user
- KWin compositor
- Composited windows
- GitHub release service
Connections 21
- Desktop user → Tray UI: adjusts settings
README.md - Desktop user → Profile editor: edits profiles
README.md - Desktop user → CLI controls: runs commands
README.md - Tray UI → D-Bus API: sends settings
tray/main.cpp - Profile editor → D-Bus API: sends profiles
tray/main.cpp - CLI controls → D-Bus API: controls effect
- Tray UI → D-Bus trust check: verifies owner
tray/dbus_security_p.h - Tray UI → UI widgets: uses controls
tray/main.cpp - Profile editor → UI widgets: uses controls
tray/main.cpp - Tray UI → Theme styling: builds stylesheet
tray/main.cpp - Effect plugin → Window color grading: creates effect
effect/main.cpp - KWin compositor → Effect plugin: loads plugin
effect/main.cpp - D-Bus API → Window color grading: exposes controls
effect/vibranceeffect.h - Window color grading → Composited windows: grades frames
- Window color grading → App profiles: selects profile
effect/vibranceeffect.cpp - App profiles → Glob matching: matches identities
effect/vibranceeffect.cpp - Window color grading → RGB shader: applies RGB gains
README.md - Window color grading → Persistent settings: persists settings
effect/vibranceeffect.cpp - Window color grading → Shared limits: uses bounds
effect/vibranceeffect.cpp - Tray UI → Update check: offers check
README.md - Update check → GitHub release service: requests release
tray/main.cpp