🇮🇱 Help defend Israel from Gaza terrorists — Donate to FIDF → הגנו על ישראל מפני טרור בעזה — תרמו עכשיו
                 ▄▄▄
 ▄█████▄    ▄███████████▄    ▄███████   ▄███████   ▄███████   ▄█   █▄    ▄█   █▄
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   ███  ███   ███  ███   ███
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   █▀   ███   ███  ███   ███
███   ███  ███   ███   ███ ▄███▄▄▄███ ▄███▄▄▄██▀  ███       ▄███▄▄▄███▄ ███▄▄▄███
███   ███  ███   ███   ███ ▀███▀▀▀███ ▀███▀▀▀▀    ███      ▀▀███▀▀▀███  ▀▀▀▀▀▀███
███   ███  ███   ███   ███  ███   ███ ██████████  ███   █▄   ███   ███  ▄██   ███
███   ███  ███   ███   ███  ███   ███  ███   ███  ███   ███  ███   ███  ███   ███
 ▀█████▀    ▀█   ███   █▀   ███   █▀   ███   ███  ███████▀   ███   █▀    ▀█████▀
                                       ███   █▀

Beautiful, Fun & Opinionated Linux by DHH

The malleable OS for the age of agents. Where you can vibe your way through every alteration, tweak, and desire. Be the Omarch and command your agent!

Theming September 1, 2026 • 7 min

Omarchy Top Bar & Waybar: Customizing Quickshell

Customize Omarchy's Quickshell top bar (Waybar style): widgets, workspaces, tray, and building your own QML modules.

M
Mikael Lund
waybar • quickshell • top bar
Share

Omarchy Quattro moved from Waybar to Quickshell (QML). Same idea — top bar — but QML makes custom widgets trivial and theme-aware.

Anatomy

  • Left: app launcher / logo
  • Center: workspaces 1-10 (Hyprland)
  • Right: tray, network, sound, battery, notifications, clock

Config: $OMARCHY_PATH/config/quickshell/ + user overrides ~/.config/quickshell/. Theme styles wire via omarchy.current.theme.

Quick tweaks

// ~/.config/quickshell/shell.qml  (example)
PanelWindow {
  // move bar to bottom, increase height
  anchors.top: false
  anchors.bottom: true
  implicitHeight: 38
}
/* if you still have Waybar fallback: ~/.config/waybar/style.css */
#workspaces button.active { background: #7dcfff; }

Pick style: Super+Alt+Space → Style → Theme → Top Bar variant.

Add a widget: CPU graph

import Quickshell
import QtQuick

Text {
  text: SystemInfo.cpuUsage + "%"
  color: Theme.foreground
}

Place in ~/.config/quickshell/modules/cpu.qml, import in shell.qml, quickshell reload.

Tray & notifications

  • Tray follows XDG status-notifier, shows Discord/Slack web apps, 1Password, network.
  • Notifications via mako (config ~/.config/mako/config). Theme syncs colors.

Debug: quickshell --help, journalctl --user -u quickshell, hyprctl clients to find bar window.

If you prefer Waybar, you can keep it: install waybar, disable Quickshell autostart in ~/.config/hypr/autostart, but you’ll lose theme sync.

Reference: Omarchy Top Bar manual.

#waybar#quickshell#top bar#customization#qml ~197 words
← All posts Official Manual ↗