Omarchy Edition • Hyprland & Qt 6

Native Frosted-Glass Radio for Omarchy

Uncompromising desktop integration: BearWave for Omarchy features live theme detection, translucent glass surfaces, and full Omarchy bar controls in your Hyprland environment.

Open Marketplace View Installation GitHub

~/.local/state/omarchy/.../colors.toml Frosted Glass Omarchy Bar Widget No Flatpak Required

BearWave — Omarchy Hyprland Workspace

translucent • acrylic

Integration

Tailor-made for Omarchy & Hyprland

No generic wrapper. BearWave is directly coupled to Omarchy configuration and UI specifications.

Dynamic Theme Sync

Picks up your active Omarchy color scheme from colors.toml and adopts the palette and system typography in real time.

Native Frosted Glass

Optimized for Hyprland with translucent acrylic surfaces, smooth drop shadows, and frameless client chrome.

Omarchy Bar Controls

Dedicated bar widget in the Omarchy panel with instant mouse control without opening the main window.

Lightweight & Native

Pure Qt 6 & QML, no heavy Electron dependencies. Built natively for your user profile and architecture.

Bar Integration

Complete Control in the Omarchy Bar

Manage playback directly via the status bar widget using simple mouse actions:

~/.config/omarchy/plugins/de.nerdbear.bearwave/omarchy/BarWidget.qml

Compact status icon in the Omarchy bar with live status (queries MPRIS every 2.5s and highlights during playback)

Left-Click

Open / bring main window to foreground (or launch installer)

Middle-Click

Pause/resume playback; launch BearWave if app is stopped

Right-Click

Stop playback (sends MPRIS Stop, app remains open)

Visuals

Screenshots & Aesthetics

See how BearWave fits into the Omarchy ecosystem

Frosted-glass main window in Omarchy theme

Active playback in floating Hyprland window

Worldwide station catalog with Radio Browser API

Now Playing detail view & stream artwork

Install

Install on Omarchy

Choose your preferred installation method. We recommend using the official Omarchy Plugin Marketplace.

Recommended / Marketplace

Omarchy Plugin Marketplace

BearWave is officially listed in the Omarchy Plugin Marketplace. Installation is fully automated, including the status bar widget, dependencies, and theme integration.

Open in Plugin Marketplace

Omarchy CLI

Terminal Installation

Run the following command in your Omarchy terminal to install and enable the plugin directly:

terminal

omarchy plugin add https://github.com/spalencsar/bearwave_omarchy.git --enable

Open GitHub Repository

Source Build

Manual Build from Source

Alternatively, you can clone the repository and run the included installer script for Omarchy:

terminal

git clone https://github.com/spalencsar/bearwave_omarchy.git
cd bearwave_omarchy
./install-omarchy.sh

View installer script on GitHub

Universal vs. Omarchy

Looking for the standard desktop version?

For GNOME, KDE Plasma, Sway, or Flatpak installations on standard Linux distributions, check out the universal desktop edition.

Switch to Standard Desktop

Updates

Omarchy Edition Changelog

All notable changes and updates specific to the Omarchy release.

Version 1.3.0

2026-10-18

Added

Native Omarchy session detection.
Live palette loading from the active Omarchy colors.toml.
Automatic palette refresh after an Omarchy theme change.
Omarchy monospace typography and native Hyprland frosted-glass surfaces.
A compact Omarchy layout with a framed sidebar, wide station list, plain metadata rows, and a full-width bottom player.

Changed

BearWave is now a local Omarchy-only application.
Local CMake/Ninja builds are the supported build and installation path.
A minimal fallback palette remains for diagnostics when the local Omarchy palette cannot be read.
Forgejo Actions now builds and tests every change; successful pushes to main mirror the tested revision to the public GitHub repository.

Security

Block artwork requests to loopback, private, link-local, reserved, and otherwise non-public network addresses, including unsafe DNS answers and redirects.
Protect persisted stream URLs by enforcing owner-only configuration directories and files and by using atomic private-file writes.
Render externally supplied station names, stream metadata, playback status, history, tags, and codec details as plain text so markup cannot trigger network requests from the UI.

Removed

Container packaging manifests, build scripts, generated artifacts, and deployment documentation.