phosphor-shell-picker

Wallpaper and theme strip that previews palettes on the live desktop.

The Phosphor.Picker strip runs along the bottom screen edge with wallpaper candidates, theme presets, and Apply actions. It has no preview pane. Hovering a wallpaper runs matugen on it and retints the live PaletteStore, so the whole shell takes that palette while the pointer rests there, and leaving without Apply restores the previous one. RetintController debounces the hover so a sweep across the strip runs matugen once, snapshots the palette on the first preview, and then either restores or commits it. The four fixed spectrum stops are stripped from every incoming palette. WallpaperCandidates scans the XDG wallpaper directories for plain images and Plasma wallpaper packages, and ThemePresets lists the built-in Dark and Light palettes plus any palette files in the user's directory. The module also ships WallpaperSurface, the shell's per-output background wallpaper, which crossfades to a hovered candidate.

Full API →

Key types

Picker
The bottom-edge strip: candidates, theme tiles, Apply and Apply on all screens.
RetintController
Debounced live retint with a restore snapshot; commit() keeps the palette.
WallpaperCandidates
Scans wallpaper directories for images and Plasma packages, current wallpaper first.
ThemePresets
Built-in Dark and Light palettes plus user palette files, each with five swatches.
WallpaperSurface
Per-output Background-layer wallpaper with a two-slot crossfade.

Dependencies

See also

References