omarchy-autohide-bar
A lightweight Omarchy / Quickshell service plugin that automatically hides the bar when it is not in use and reveals it on demand.
Supports all bar positions (top, bottom, left, right) and works across multiple monitors — hovering any screen edge reveals the bar on every screen.
Installation
omarchy plugin add https://github.com/mohamed8eo/autohiden-bar.git --enable
Then reload the shell:
omarchy-shell reload
Core behavior
- Hidden by default — the bar starts hidden when the shell loads.
- Edge hover reveal — move the pointer to the screen edge where the bar sits (a 1px trigger strip) to show it.
- Top bar: hover the top 1px of the screen
- Bottom bar: hover the bottom 1px
- Left bar: hover the left 1px
- Right bar: hover the right 1px
- Auto-hide — the bar hides after you leave both the trigger edge and the bar itself.
- Popout aware — the bar stays visible while a bar menu or panel popout is open.
- Empty workspace — the bar stays visible when the focused workspace has no windows.
Configuration
All timing options live at the top of Service.qml:
readonly property int hideDelayMs: 300 // wait before hiding (milliseconds)
readonly property int pollIntervalMs: 50 // how often visibility is checked
Make hide/show feel slower
Increase hideDelayMs to keep the bar visible longer after you move the pointer away. Good starting values:
| Feel | hideDelayMs |
|---|---|
| Snappy (default) | 300 |
| Relaxed | 600–1000 |
| Very slow | 1500–3000 |
Example — wait 1 second before hiding:
readonly property int hideDelayMs: 1000
After editing, reload the shell:
omarchy-shell reload
Make hide/show look smoother (slide animation)
The plugin toggles Omarchy’s barHidden flag, which moves the bar off-screen instantly by changing panel margins. There is no built-in slide animation in this plugin.
If you want a visible slide/fade instead of an instant pop:
- Hide delay (above) — often enough; a short pause before hiding feels much less abrupt even without animation.
- Omarchy bar margins — smooth motion would require a
NumberAnimation(or similar) on the bar panel margins in Omarchy’sBar.qml. That lives in the shell, not in this plugin. A typical starting point isduration: 250–400withEasing.OutCubic. - Hyprland — layer-surface animations depend on your compositor settings; they may not animate bar margin changes.
This plugin controls when the bar hides; Omarchy controls how it moves on screen.
Files
| File | Purpose |
|---|---|
manifest.json |
Plugin metadata for Omarchy |
Service.qml |
Autohide logic and edge hover triggers |
License
MIT — see LICENSE.