Omahub
← All plugins
S

Flush bar

by Scott Jones

Let a transparent bar sit flush over the windows below it

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
b62a65d
Scanned
1 week ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:55

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/scottjones/omarchy-flush-bar.git ~/.config/omarchy/plugins/scottjones.flush-bar

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
b62a65d
Reviewed
1 week ago

The plugin only adjusts Hyprland window gaps based on bar transparency and position via hyprctl eval. The deterministic finding about an external host is a documentation-only git clone install command in the README, not executable code. The shipped scripts and QML are straightforward, non-obfuscated, and contain no destructive, persistent, or credential-related behavior.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/scottjones/omarchy-flush-bar --enable
Appearance #Hyprland #bar #quickshell

Flush bar

An Omarchy shell plugin that lets a transparent bar sit flush over the windows below it — no widget overlap, no new setting, and no change to any default. Works on any edge, live, and multi-monitor. This lets the text of the workspaces and icons be centered in the "empty" space above your windows rather than offset by the gap.

This is the plugin form of basecamp/omarchy#6381.

https://github.com/user-attachments/assets/b6d59de0-2c69-44bf-aee7-5dd97a167948

How it works

The bar already reserves only its own thickness (its layer-shell exclusive zone), so it never overlaps a window. What's missing is the window gap under it: this plugin keeps the gap on the bar's edge in step with the bar — 0 when the bar is transparent (windows flush) or the same as the other edges when opaque.

It ships as a headless service plugin. The shell persists every bar change (edge moves and the transparency toggle) into shell.json, which the service observes through shell.barConfig, so it reacts to the same state the bar itself renders — on change, once at startup, and on a Hyprland config reload (which resets gaps_out, so the service re-asserts it). Startup also re-asserts for a few seconds and again after monitor add/remove, so a late boot-time hyprctl reload (e.g. clamshell/monitor reconciliation) cannot strand the gap.

The gap logic lives in gaps.sh. It reads the current gaps_out and only ever touches two edges: the bar's own edge, and the edge the bar just moved off of (restored to the window gap so a moved-away edge isn't stranded at 0). Every other edge is left exactly as configured, so per-edge custom gaps, a hand-set zero, and toggles like window-no-gaps are preserved.

Requirements

  • Omarchy Quattro with its Quickshell-based shell and Lua-enabled Hyprland (hyprctl eval). The service reads the shell-provided shell.barConfig.
  • bash, python3, and hyprctl for the gap helper.
  • flock (from util-linux) to serialize overlapping gap updates.

These dependencies are included in a standard Omarchy installation. No extra packages or build step are required.

Install

omarchy plugin add https://github.com/scottjones/omarchy-flush-bar.git
omarchy plugin enable scottjones.flush-bar

Or by hand:

git clone https://github.com/scottjones/omarchy-flush-bar.git ~/.config/omarchy/plugins/scottjones.flush-bar
omarchy-shell shell rescanPlugins
omarchy plugin enable scottjones.flush-bar

Making the bar transparent

The transparent bar is an existing Omarchy feature, not something this plugin adds — the plugin only supplies the missing gap while it's on. Two ways to turn it on:

  • Double-click an empty spot on the bar (left button) to toggle it.
  • omarchy bar transparent toggle — or pass true / false outright.

Either path writes bar.transparent into shell.json, which is the state the service watches, so the gap follows on the same change. Dragging the bar to another screen edge works the same way: it persists bar.position, and the gap moves with it.

Remove

omarchy plugin disable scottjones.flush-bar   # stop the syncing
omarchy plugin remove scottjones.flush-bar    # delete the checkout

If your bar was transparent and flush, reload Hyprland or set general:gaps_out to restore the gap on the bar's edge. The plugin changes gaps_out only at runtime — it never writes to your configuration files.

Test

./test/gaps-test.sh