"Every once in a while, a tool comes along that changes how you interact with your desktop forever. Music shouldn't require a dedicated window, an extra workspace, or half a gigabyte of RAM. It should simply be there — woven into the cosmos of your bar."
There are plenty of music players in Linux, but none like this for Omarchy OS.
Opening an entire browser window or a heavy Electron app just to play background music fractures your focus, clutters your Hyprland workspaces, and burns 400MB–600MB of memory.
OmaOpus is the first and only full-featured, zero-footprint music workstation living natively in the Omarchy top bar.
It runs as a silent, featherweight background daemon powered by C-speed mpv IPC. One click on your bar reveals a studio-grade interface with millisecond YouTube search, gapless queue autoplay, persistent favorites, and a hardware-accelerated 32-band audio visualizer. When closed, it consumes 0.0% CPU and less than 15MB of RAM.
- Zero Desktop Clutter: Sits unobtrusively in your status bar as an animated live mini-equalizer pill when playing, and a tranquil icon when idle.
- Headless Background Audio: Music continues playing uninterrupted in the background through a low-latency Unix socket daemon.
- Microscopic Footprint: Strict 16MB demuxer ring buffers keep RAM usage locked under 15MB.
- Native GPU SceneGraph Rendering: 32 hardware-accelerated equalizer columns running at 40 FPS with zero frame drops.
- Authentic Hi-Fi Ballistics: Instant transient attack with smooth logarithmic analog meter decay, simulated gravity peak-hold caps, and glossy acrylic baseline reflections.
- Studio Frequency Axis: Calibrated frequency markers (
20Hz·100Hz·500Hz·1kHz·4kHz·10kHz·20kHz). - 4 Cosmic Palettes (interactive click-to-cycle):
- ★ Cyber Neon: Neon Cyan -> Electric Blue -> Violet -> Hot Pink peaks.
- ☀ Solar Amber: Warm McIntosh vintage gold and molten amber glow.
- ✦ Matrix Emerald: Cyberpunk electric mint, jade, and deep emerald.
- 🌌 Electric Violet: Midnight indigo to radiant lavender and orchid.
- True Idle Silence: Guaranteed 0.0 resting baseline when paused or stopped. No phantom jitter.
- Predictive Pre-Buffering: While the current track is playing, OmaOpus resolves and pre-buffers the next track in the background.
- Continuous Flow: Automatically transitions to the next track with zero awkward silence.
- Queue Management: One-click reordering, track removal, and instant queue clearing.
- Sub-Second Search: Fast flat-playlist extraction delivers YouTube search results in milliseconds.
- Disk Caching: Frequently searched queries load from disk in under 50ms.
- Persistent Favorites: Star your favorite tracks with one click (
) to build your permanent local music library.
- Full keyboard navigation: Type to search, navigate with
↑ / ↓, pressEnterto play, and tapEscto dismiss. - Scriptable CLI & global keybinding support via QuickShell IPC:
quickshell ipc call maen.omaopus toggle # Toggle dropdown player quickshell ipc call maen.omaopus play # Toggle play / pause quickshell ipc call maen.omaopus next # Skip to next track quickshell ipc call maen.omaopus prev # Previous track
| Metric | Web Browser (YouTube / Web Player) | OmaOpus |
|---|---|---|
| RAM Footprint | ~400 MB – 650 MB | < 15 MB (97% memory reduction) |
| Idle CPU Load | 2.0% – 6.0% | ~0.0% |
| Window Clutter | Requires browser tab / window | 100% In-Bar Popup (0 windows) |
| Audio Latency | Script initialization overhead | < 0.5s (direct audio stream) |
| Audio Spectrum | None / basic web canvas | 32-Band Hardware SceneGraph FFT |
| Desktop Integration | Detached web app | Native Omarchy & Quickshell UI |
Install in one command through the official Omarchy plugin manager:
omarchy plugin add https://github.com/MaenExists/omaopus.git --enableThe widget will immediately appear in your top bar between your status widgets.
| Action | How to Trigger |
|---|---|
| Open / Close Player | Left-Click Top Bar Icon or Super+Shift+M |
| Play / Pause | Center control button or IPC play |
| Next / Previous Track | / buttons or IPC next / prev |
| Cycle Cosmic Palette | Click theme capsule (CYBER NEON / SOLAR AMBER / MATRIX EMERALD / ELECTRIC VIOLET) |
| Toggle Visualizer | Click / in player header |
| Autoplay Toggle | Click / in player header |
| Add / Remove Favorite | Click / on any track |
| Queue Track | Click on search results |
| Dismiss Panel | Esc or click outside |
- Quickshell & QML 2.0: Native hardware-accelerated desktop UI rendered directly via Wayland / OpenGL.
- Headless mpv Daemon: High-fidelity audio playback over low-latency PipeWire / PulseAudio.
- Python FFT Engine: Log-spaced discrete 32-band FFT with dynamic Auto-Gain Control and transient onset detection.
- yt-dlp: High-speed audio-only stream extraction (
251/140/ba).
MIT © MaenExists