Skip to content
ArchEclipse

Common pages

↑↓to navigate↵to openescto close
Bar
On this page

Configuration

Bar

How the ArchEclipse bar is structured, how islands open, and how to control it with IPC.

The bar is one Quickshell window per monitor, created by Bar.qml inside a Variants model over Quickshell.screens. Each bar window is full-monitor height, but most of it is an input mask: only the visible pill or open island receives pointer events. This is what allows panels to grow in place without reallocating a layer surface.

text
shell.qml
└── Variants (one per screen)
    └── Bar.qml
        ├── DefaultBar          # always-on status pill
        ├── SearchIsland        # launcher
        ├── OverviewIsland      # workspace overview
        ├── WallpaperIsland     # wallpaper picker
        ├── PlayerIsland, WeatherIsland, SystemMonitorIsland
        ├── OsdIsland           # volume/brightness feedback
        ├── ScreenshotIsland, RecordingIsland
        └── LeftIsland, RightIsland

The main pill and islands#

The central pill displays the default status layout. Actions replace its body with an island:

  • SUPER + SUPER_L — launcher (search)
  • SUPER + SHIFT + TAB — workspace overview
  • SUPER + W — wallpaper picker
  • SUPER + M — standalone media window, not a bar island
  • the media, volume, brightness, network and weather cells expand on hover

BarState manages which state is displayed per monitor. States have fixed priorities, so opening the wallpaper picker cannot be hidden by a volume change:

StatePriority
default0
recording40
volume / brightness / network / player / weather / system80
overview85
control90
left / right panels93
wallpaper95
search100

Volume, brightness and network pulses auto-close after a few seconds. The left, right, wallpaper, overview and search islands stay open until you close them (with Esc, their shortcut again, or a click outside).

Panels and hot zones#

The left and right panels are side pills, not separate windows. They dock to the screen edges and push the main pill toward the centre while open.

  • Hot zones: hovering the left or right edge opens the matching panel. Both are enabled by default; the strip is 5 px and can be changed in Settings.
  • Hover pressure: pills and islands wait revealInPressure (default 250 ms) before opening and stay open for revealOutPressure (default 1000 ms) after the pointer leaves.
  • Locks: panels can be locked open from the shell data. Locked panels ignore close guards until unlocked.
  • Per-monitor widths: Settings stores a width override per monitor name.

There is currently no smart-hide control in the Settings panel: the bar is visible unless hidden explicitly. TODO: document the intended smart-hide behaviour; barSmartHide and barFullWidth exist in the settings schema but are not wired to bar visibility.

Orientation and appearance#

Settings → Bar switches the bar between the top and bottom edge. The rest of the bar's visual tokens come from Settings:

TokenDefaultUsed for
uiOpacity0.618Pill and panel surfaces
uiRadius12Corners
uiPad6Content inset
uiSpacing6Gaps between cells
uiFontSize12Bar text, with derived caption sizes
dateFormat%H:%MClock; also %I:%M %p

The accent and surface colors come from the wallpaper palette, not from the settings file. See Theming and Customization.

Hiding and restarting#

SUPER + ALT + Backspace toggles the bar on the focused monitor. The setting is kept per monitor until the shell restarts. Opening a panel or island forces the bar visible again.

SUPER + B restarts the entire shell through ~/.config/hypr/config/scripts/bar.lua. The script acquires a lock, stops the existing Quickshell process for the ArchEclipse config, launches a new one, and syncs the greeter theme. Its log is:

text
/tmp/qs-bar-$USER.log

You can run the same restart manually:

bash
lua ~/.config/hypr/config/scripts/bar.lua

IPC#

The shell exposes two IPC targets: bar and brightness (plus internal capture targets). Most commands take a monitor name. Get the focused monitor first:

bash
MON=$(hyprctl activeworkspace -j | jq -r '.monitor')

Then call the shell:

bash
qs -p ~/.config/quickshell/archeclipse ipc call bar toggleBar "$MON"

Useful bar commands:

CommandArgumentsEffect
toggleBarmonitorShow/hide the bar
toggleSearchmonitorToggle the launcher
toggleLeftPanelmonitorToggle the left panel
toggleRightPanelmonitorToggle the right panel
toggleOverviewmonitorToggle the workspace overview
togglePanelname, monitorToggle a registered island by name (wallpaper-switcher, media-panel, …)
showWidgetwidget, monitorOpen the left panel on a tab (SettingsWidget, KeyBinds, …)
clipboardmonitorOpen the launcher with cb
emojismonitorOpen the launcher with emoji
notesmonitorOpen the launcher with note
appsmonitorOpen the all-apps list
presetSearchquery, monitorOpen the launcher with a query

Examples:

bash
# wallpaper picker on the focused output
qs -p ~/.config/quickshell/archeclipse ipc call bar togglePanel wallpaper-switcher "$MON"

# open Settings directly
qs -p ~/.config/quickshell/archeclipse ipc call bar showWidget SettingsWidget "$MON"

The brightness target provides increment, decrement, set, get and per-monitor variants (incrementFor, decrementFor, adjustFor, setFor). Hyprland's brightness keys call these first and fall back to config/scripts/brightness.lua when the shell is not running.

bash
qs -p ~/.config/quickshell/archeclipse ipc call brightness incrementFor "$MON"