Omaxian Shell · v1.1

The shell, for the Debian you already run

A port of the Omarchy shell to debian-based distros on X11 / XLibre + i3

Tracks Omarchy 4.5.0.

install
curl -fsSL https://raw.githubusercontent.com/aozora/omaxian/main/bootstrap.sh | bash

An X11 session with i3. Log out and back in after installing. Tested on Debian 13, Devuan Excalibur, Xubuntu 26.

What is it?

Omaxian brings the Omarchy shell — its bar, dock, menu, themes and omarchy-* commands — to the Debian family on X11 / XLibre and i3, with no Wayland, no Hyprland and no dependency on systemd or other init systems.

Not a distribution — it ports only the shell, and X11 differs from Wayland, so compatibility with Omarchy is partial.

See it

Menu — Apps and omarchy-* commands in one launcher. Theme: Nebula Ridge.
Media — MPD alongside every MPRIS player. Theme: Everforest.
Settings — Bar, dock, widgets and startup apps — no text editor needed. Theme: Miasma.
Key bindings — Super+K cheat-sheet of this session’s binds. Theme: Retro 82.
Control Panel — Audio, Bluetooth, wallpaper, theme and monitors. Theme: Catppuccin.

Highlights

  • ▸
    Control PanelSuper+Ctrl+O Audio, Bluetooth, wallpaper, theme and monitors in one popup.
  • ▸
    SettingsSuper+Ctrl+S Bar, dock, fonts, keyboard layouts and startup apps in a real window — no config files.
  • ▸
    Dock Pinned apps, running-app dots and hover magnification.
  • ▸
    Display profilesSuper+Ctrl+D Resolution, position and on/off per monitor, saved per layout.
  • ▸
    Agents Bar meter and panel for AI coding subscriptions — limits, balances and local stats across major providers.
  • ▸
    Languages Switch the shell UI among 50 languages; strings reload without restarting Quickshell.
  • ▸
    Media widget MPD and every MPRIS player behind one control.
  • ▸
    Community plugins Opt-in weather, calculator, email and more — each checked with omarchy-plugin-check.
  • ▸
    Community apps Standalone ports — Meeting Recorder, Monologue, Signed and Disktree — their own process and launcher, not shell plugins.

Community plugins

Opt-in third-party ports, not part of the default desktop. Pick them during installation, or check any other Omarchy plugin with omarchy-plugin-check.

  • ▸
    Nag Disposable alarms — type a wall-clock time and the bar counts down to it.
  • ▸
    Better Weather Open-Meteo, wttr.in and RainViewer forecasts on the bar.
  • ▸
    Running Cat RunCat-style CPU cat on the bar — runs with load, sleeps when idle.
  • ▸
    System Monitor Low-overhead /proc and /sys dashboard with btop launch from the bar.
  • ▸
    Proton Pass Proton Pass search and copy via pass-cli — username, password, or TOTP from the bar.
  • ▸
    Speaker Calibrator (PulseAudio) Microphone-driven parametric speaker tuning for PulseAudio.
  • ▸
    Speaker Calibrator (PipeWire) Microphone-driven parametric speaker tuning for PipeWire.
  • ▸
    Omamail Gmail, HEY, JMAP and IMAP in a Rust-backed client — bar toggle or mailto: handoff.
  • ▸
    Voxtype Aura Theme-aware Voxtype dictation overlay for the shell.
  • ▸
    Calculator Spotlight-style quick calculator — result as you type, Enter copies it.
  • ▸
    Omastorm Live NEXRAD and OPERA radar in a native window (engine fetched on first open).
  • ▸
    Webcam Controls V4L2 webcam preview and device controls from the bar.
  • ▸
    yt-dlp Download queue for yt-dlp — paste a link, pick video or audio, run from the bar.
  • ▸
    OmaKeePick KeePass picker with Rust daemon — search a KDBX, auto-type or copy, lock state on the bar.
  • ▸
    Radio Atlas World radio on a rotatable globe — play stations through the shell media controls.

Community apps

Standalone ports — GTK, Qt and the like — not Quickshell plugins and not part of the default install. Each app ships its own install.sh.

  • ▸
    Meeting Recorder GTK 4 recorder — mic and system audio as two tracks, local whisper.cpp transcription, optional waveform on the bar.
  • ▸
    Monologue Qt Quick webcam recorder — pick a camera and mic, Space to record, then trim and save an H.264 MP4.
  • ▸
    Signed Qt Quick PDF signer — place a signature, text, or a date, and save a copy. Optional self-signed seal.
  • ▸
    Disktree GPUI treemap of what fills a disk — local directories and SSH hosts, with a review before anything is removed.

Before you install

  • Stock Ubuntu 26.04 ships without X11 — use Xubuntu, or `sudo apt install xubuntu-desktop`.
  • The shell needs Quickshell ≥ 0.2 (0.3.x tested). Debian 13+ usually gets it from apt; on older Debian or Devuan without that, build from source. Build from source →
  • Prefer a clone or manual steps? See the install docs.