Omarchy Quattro Plugin Marketplace Guide 2026: Customize Your Arch Linux Desktop with omarchyplugins.com

"Bar, menu, notifications — everything is a plugin. A Linux desktop you can reassemble to your taste."

The short version: omarchyplugins.com is a community marketplace for plugins built for "Omarchy Quattro," the Arch Linux + Hyprland desktop environment developed by 37signals. Plugins are git repos with a manifest.json, letting you add, swap, or build bar widgets, panels, menus, overlays, and services without touching Omarchy's source. As of August 2026 the registry is young, but a viral demo of building a plugin with AI in about 12 minutes has drawn attention.

This article explains what Omarchy Quattro is, how the plugin system works, how to use the marketplace, how to develop plugins, and the security caveats — with sources.

What Omarchy Quattro Is

Omarchy is a desktop environment built on Arch Linux + Hyprland, developed by 37signals (the company behind Basecamp, HEY, and Rails, led by David Heinemeier Hansson). In 2026, version 4 "Quattro" is being developed and released.

The defining feature of Omarchy 4: almost everything on the desktop runs as a plugin.

While Omarchy 3 was a curated Arch + Hyprland setup, Quattro hosts the whole desktop inside Quickshell (omarchy-shell) — one long-running process. The bar, panels, overlays, menus, notifications, OSD, lock screen, polkit dialog, clipboard manager, background switcher, idle service, and media service all run as plugins inside it.

This is not just an implementation detail. You can turn desktop components off, swap them out, or write your own without touching a line of Omarchy's source.

What omarchyplugins.com Is

omarchyplugins.com is an unofficial community registry for Omarchy plugins. It's powered by the GitHub repo "HANCORE-linux/omarchy-plugin-marketplace" (MIT license).

Features:

Discovery: search by category, tags, Most starred / viewed / copied / hearts
Source inspection: browse each plugin's git repo
One-click command copy: omarchy plugin add https://github.com/.../xxx.git
Submission: via GitHub Issue template (manifest, README, license required)
Verification: new listings require a fresh exact-commit scan and an explicit "approved-and-verified" maintainer decision

Important: this is an independent community project, not affiliated with Omarchy or 37signals (stated in the README). And "listed" does not mean "security-audited."

The 6 Plugin Kinds

Plugins declare their type via kinds in manifest.json:

Kind	What it is
`bar-widget`	A component placed into the active bar (clock, volume, etc.)
`bar`	A full bar that can replace the built-in bar
`panel`	A floating window (OSD, detail panels)
`overlay`	A fullscreen overlay (background picker, etc.)
`menu`	A summoned menu surface
`service`	A headless singleton with no UI

Only one full bar can be active at a time. Panels, overlays, and menus load when summoned; keepLoaded: true keeps them resident. First-party services load at startup.

Installing & Managing Plugins

A plugin is a git repo with a manifest.json at its root. Adding one clones it into ~/.config/omarchy/plugins/<id>/.

omarchy plugin add https://github.com/acme/omarchy-weather.git
omarchy plugin update    # fetch, show diff, fast-forward
omarchy plugin remove acme.weather

New plugins land disabled so you can review code before enabling
Updates show a diff before applying
Setup › Plugins offers Enable, Disable, Add, Clone, Remove
--yes skips every prompt (for scripts and agents)

Customizing built-ins is easy too: omarchy plugin clone omarchy.clock --edit copies a first-party plugin to your config directory for editing. Saving files auto-reloads.

Plugin Development Basics

The recommended flow is to clone and modify an existing plugin:

omarchy plugin clone omarchy.clock --edit

This creates ~/.config/omarchy/plugins/yourname.clock/:

├── manifest.json      ← plugin definition
├── BarWidget.qml      ← bar display (QML)
├── Panel.qml          ← detail panel (QML)
└── Model.js           ← logic

Example manifest.json:

{
  "schemaVersion": 1,
  "id": "yourname.clock",
  "name": "Custom Clock",
  "version": "1.0.0",
  "author": "Your name",
  "license": "MIT",
  "description": "A small clock with a details panel for the Omarchy bar.",
  "kinds": ["bar-widget"],
  "entryPoints": { "barWidget": "BarWidget.qml" }
}

Validate with:

omarchy plugin validate "$HOME/.config/omarchy/plugins/yourname.clock"
qmllint -I "$OMARCHY_PATH/shell" "$PLUGIN_DIR/BarWidget.qml" "$PLUGIN_DIR/Panel.qml"

In August 2026, a video showed building a plugin with AI in ~12 minutes, zero hand-written code (NO SIGNAL channel, 2,200+ views). Omarchy Quattro ships with built-in skills that help agents understand the system, so you can tell Claude "I want to build a plugin" and it starts building.

Security Caveats

Plugins run unsandboxed with your user permissions. A plugin is software you execute — not a wallpaper pack.

The marketplace runs limited automated checks + may do manual review, but this is not a security audit, certification, or guarantee
Review the source code, requested capabilities, and dependencies before installing
Marketplace install/update commands clone mutable upstream HEAD, not pinned to the reviewed commit
Report suspicious plugins via GitHub's private security report form

Omarchy's official docs say the same: plugins are code you run.

Summary

omarchyplugins.com is the unofficial community marketplace for Omarchy Quattro plugins
Omarchy Quattro uses a "whole desktop as plugins" architecture
Plugins are git + manifest.json + QML; omarchy plugin add installs instantly
Six kinds (bar-widget, bar, panel, overlay, menu, service) compose freely
Built-in cloning + AI assistance is rapidly lowering the development barrier
But plugins are unsandboxed — always inspect source before installing

The era of "reassembling your Linux desktop to taste" is getting closer with Omarchy Quattro and this marketplace.

Sources

omarchyplugins.com (Browse Plugins / Develop a Plugin)
GitHub: HANCORE-linux/omarchy-plugin-marketplace
GitHub: basecamp/omarchy (quattro branch, docs/omarchy-shell.md)
The Omarchy Manual (Shell Plugins)
X (@lxztlr 2026-08-20, omaplug)
YouTube: NO SIGNAL "Watch Me Build An Omarchy Quattro Plugin in 12 Minutes, Zero Code"