Skip to content

hthienloc/dms-hidden-bar

Repository files navigation

Hidden Bar

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 save bar space
  • Hover to expand - Reveal hidden widgets by hovering over the trigger area
  • Auto-collapse - Hide again after inactivity
  • Exclude items - Keep system tray or clock always visible

Usage

Action Result
Left click Toggle expand
Right click Pin/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.

Command Description
toggle Toggle expand/collapse
expand Expand the hidden area
collapse Collapse the hidden area
pin Expand and lock open (disable auto-collapse)
unpin Unlock and resume auto-collapse

Keybinding examples

Niri:

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

Hyprland:

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

License

GPL-3.0

Roadmap / TODO

  • Granular Widget Control: Settings interface to manually whitelist/blacklist specific widgets for hiding.
  • Smooth Animations: Integrated transition effects (Slide, Fade, or Bounce) when expanding/collapsing the hidden area.
  • Global Keybinding: IPC commands (toggle, expand, collapse, pin, unpin) for use with any compositor keybinding system.
  • Space-Aware Auto-Hiding: Automatically hide more widgets as the screen resolution decreases or bar congestion increases.
  • Stylized Indicators: Multiple icon sets and customizable colors for the expansion trigger to match custom themes.

About

A plugin for Dank Material Shell to manage bar widget visibility

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors