Omarchy

Show System Bridge in the Omarchy bar, with a panel for every module.

The System Bridge Omarchy plugin shows CPU and memory usage in the bar. Select the widget to open a panel with an overview of the system and a view for every module the web client has a page for, with audio, desktop, Discord, display and media controls.

Requirements

• Omarchy Quattro
• System Bridge installed with the system-bridge executable available on PATH, in a version with the client audio, client bluetooth, client desktop, client discord, client display, client hyprland, client media, client open --path and client quit --yes CLI commands
• A running local System Bridge service

Install

Review the plugin repository, then add it:

omarchy plugin add https://github.com/timmo001/omarchy-system-bridge.git

Accept the prompt to enable the plugin. For an unattended install from a repository you already trust:

omarchy plugin add https://github.com/timmo001/omarchy-system-bridge.git --enable --yes

Use

The panel starts on the overview: CPU, memory, GPU, CPU temperature and battery meters, storage, network traffic, what’s playing, and a row for each module.

Select a reading or a module to open its view. Each view has the module’s readings, and links to the matching part of the web client for anything you set up there, such as commands, disk mounts, media directories or Discord. The Bluetooth view connects or disconnects a paired device when you select it; the desktop view focuses a window or workspace when you select it, switches the keyboard layout, reloads Hyprland’s config, and centres, groups or splits the focused window or cycles to the next or previous one; the Discord view has mute, deafen and leave call; the displays view has brightness for each display that supports it; the media view has previous, play or pause, and next; and the system view lists your commands, running one when you select it.

Type to filter the rows, use Up and Down to move through them, and press Enter to select one. Backspace or the back button returns to the overview, and Escape clears the filter or closes the panel.

The header has two buttons: one opens the current view in the web client, and the other quits System Bridge, or starts it while it’s not running.

The plugin has no System Bridge settings of its own. Change those in the web client.

The plugin exposes the timmo.system-bridge shell IPC target:

omarchy-shell timmo.system-bridge toggle

Settings

• primaryOnly: show the widget only on the selected output
• primaryOutput: optional output name used when primaryOnly is enabled; the first available output is used when this is empty or unavailable

Update and remove

Review and apply the next fast-forward update:

omarchy plugin update timmo.system-bridge

Remove the plugin and its shell entry:

omarchy plugin remove timmo.system-bridge

Security

Omarchy plugins run as unsandboxed code inside omarchy-shell. Review the source before installing it.

This plugin starts system-bridge client data watch and reads System Bridge’s local settings and authentication token through that client. Its buttons run system-bridge client commands to open the web client, control the desktop, media, Discord and displays, run your allowlisted commands, and quit or start System Bridge.