phosphor-shell-dashboard

Full-screen dashboard and keybind cheatsheet drawn on the placement map.

The Phosphor.Dashboard QML module holds two full-screen overlays. Dashboard shows every virtual desktop's live placement map at once, one cell per desktop with the current one outlined, followed by calendar and media cells in the same style. Clicking a cell switches to that desktop, and on open the grid starts scaled so the current desktop's cell covers the screen, then settles. Cheatsheet draws the keybind sheet on the screen's own placement map: ChordLayout.js puts each spatial chord's label on the rect or gap it acts on, and the non-spatial chords go in a column on the right edge. Typing filters both. The sheet takes keyboard focus on demand rather than exclusively, so a chord pressed while it is open still reaches the compositor. ShortcutCatalog reads the bound chords from the PlasmaZones daemon over D-Bus and re-reads them on shortcutsChanged. Inputs are properties rather than singletons, so tests drive both surfaces with fakes.

Full API →

Key types

Dashboard
Every desktop's placement map in one grid, plus calendar and media cells.
Cheatsheet
Keybind sheet with chord labels on the rects they act on and a column for the rest.
ShortcutCatalog
Reads getShortcutsJson from the daemon and exposes the chords as rows.
DesktopCell
One desktop's placement miniature, outlined by current, urgent, or hovered state.
FullMap
The screen's cells drawn at 1:1, handing their rects to the cheatsheet.

Dependencies

See also

References