Hidden Bar

June 13, 2026 ยท View on GitHub

Hide unused bar widgets and expand them on demand.

Screenshot

Install

Use the DMS CLI:

dms plugins install hiddenBar

Or manually:

git clone https://github.com/hthienloc/dms-hidden-bar ~/.config/DankMaterialShell/plugins/hiddenBar

Features

  • Smart hide - Collapse widgets to reclaim bar space
  • Hover to expand - Reveal hidden widgets by hovering over the trigger area
  • Auto-collapse - Hide again after inactivity
  • Widget control - Automatically or manually blacklist/whitelist which widgets get hidden
  • Slide animation - Widgets slide in and out as the bar collapses (toggleable, adjustable duration)
  • Exclude items - Keep system tray or clock always visible

Usage

ActionResult
Left clickToggle expand
Right clickPin/unpin expanded state

Note

When newly adding this widget or adding other widgets to the status bar (hidden area), you need to restart DankMaterialShell (dms restart or reload session) for the plugin to recognize and manage the new widgets.

IPC Commands

Use dms ipc call hiddenBar <command> to control the bar from scripts or keybindings.

CommandDescription
toggleToggle expand/collapse
togglePinToggle pin state (prevents auto-collapse)

Keybinding examples

Niri:

bindings {
    Mod+Backslash { spawn "dms" "ipc" "call" "hiddenBar" "toggle"; }
    Mod+Shift+Backslash { spawn "dms" "ipc" "call" "hiddenBar" "togglePin"; }
}

Hyprland:

bind = SUPER, backslash, exec, dms ipc call hiddenBar toggle
bind = SUPER_SHIFT, backslash, exec, dms ipc call hiddenBar togglePin

License

GPL-3.0

Roadmap / TODO

  • Granular Widget Control: Settings interface to manually whitelist/blacklist specific widgets for hiding.
  • Smooth Animations: Slide transition that reclaims the freed space when expanding/collapsing the hidden area.
  • Global Keybinding: IPC commands (toggle, expand, collapse, pin, unpin) for use with any compositor keybinding system.