Omahub
← All plugins
J

Omaramp

by JoeJoeflyn

Retro music player for Omarchy. Winamp-inspired popout panel, live spectrum visualizer, now-playing status, and playlist controls.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
b6184f9
Scanned
2 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
b6184f9
Reviewed
2 weeks ago

This plugin is a music player widget that interacts with mpv, PipeWire, and yt-dlp for playback and visualization. The code is well-structured, uses documented external dependencies, and performs no destructive or malicious actions. The deterministic scan found no issues, and the reviewed source files show only expected audio/UI functionality.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/JoeJoeflyn/omaramp --enable
Desktop #bar #quickshell #media

Omaramp 📻

Native status bar retro music player controller and real-time audio visualizer for Omarchy.

Inspired by Winamp & cliamp.

Omarchy Plugin License: MIT

Omaramp Preview

🌟 Features

  • Retro Winamp HUD: Digital LED time counter (01:23 / 03:45), KBPS/Stereo badges, track marquee ticker, and smooth playhead scrubber.
  • 37 Live Visualizer Styles: Categorized selector featuring:
    • Classic & VU: Bars, Classic LED, Peaks, Columns, Bars Dot, Bars Outline, Bricks, Stereo VU, ASCII.
    • Waves & Scopes: Siri Wave (Apple iOS 9 algorithm), Sine Wave (standing acoustic harmonics), SoundCloud Wave (ultra-thin asymmetrical), Telegram Wave (voice capsule pills), DAW Peak Wave (RMS + True Peak dual-layer), LED Scrubber (discrete matrix blocks), Heatmap Wave (thermal energy gradient), Baseline Wave (grounded floor spectrum), XY Scope, Waveform, Heartbeat.
    • Synth & Retro: Retro Synth, Flame, Pulse, Matrix, Terrain, Binary, Logo, Mosaic.
    • Particles & Nature: Sand, Firework, Geyser, Firefly, Sakura, Bubbles, Rain, Butterfly, Scatter.
  • 10-Band Equalizer & DSP Effects:
    • 10-Band Pro EQ presets: Flat, Bass Boost, Rock, Electronic, Pop, Vocal Clarity, Acoustic, Treble Boost, Late Night.
    • 3D Spatial Audio Widener: Binaural stereo expansion.
    • EBU R128 Dynamic Loudness Normalizer: Anti-earblast volume evening.
  • Synced Lyrics: Live word-by-word synced lyrics powered by lrclib.net.
  • Streaming & YouTube Integration:
    • Instant YouTube track search with auto-thumbnail prefetching.
    • Direct-stream audio playback with smart URL caching and prefetching.
    • Direct Spotify track links (open.spotify.com/track/...) and playlist/album importer.
  • Queue Manager (Up Next): Interactive queue tab with reordering, queue count badges, and auto-play next.
  • Full Transport Deck: Play/Pause, Next, Prev, Stop, Shuffle, Repeat, Volume slider, and Speed controls (0.5x–2.0x).
  • Keyboard Shortcuts: Space (play/pause), Left/Right (seek), Up/Down (volume), / (search), m (mute), Esc (close).
  • Zero-Overhead Idle: Sub-process sleep and lightweight PipeWire monitoring when paused or closed (~42 MB RAM, ~0.5% CPU playback).
  • Status Bar Widget:
    • Left Click: Toggle popup player panel.
    • Middle Click: Instant Play/Pause toggle.
    • Right Click: Skip to next track.
    • Mouse Wheel: Smooth volume adjustment directly from the bar.

📦 External Dependencies

Omaramp requires the following packages for audio playback, PipeWire recording, spectrum processing, and media streaming:

Dependency Purpose Package (Arch Linux)
mpv Headless media playback engine & IPC socket control mpv
pipewire Real-time audio server and recording (pw-record) pipewire / pipewire-pulse
python-numpy Zero-copy C fast Fourier transform (FFT) spectrum calculations python-numpy
yt-dlp YouTube track search and audio streaming yt-dlp

Install Dependencies:

omarchy pkg add mpv pipewire python-numpy yt-dlp

📥 Installation

Install Omaramp using the Omarchy CLI:

omarchy plugin add https://github.com/JoeJoeflyn/omaramp --enable
omarchy restart shell

Manual Bar Configuration

Add "omaramp" to your desired status bar section in ~/.config/omarchy/shell.json:

{
  "bar": {
    "sections": {
      "right": [
        "omaramp",
        "omarchy.audio",
        "omarchy.network",
        "omarchy.battery"
      ]
    }
  }
}

🗑️ Removal & Uninstallation

To disable and remove Omaramp from your system:

# 1. Remove plugin from Omarchy
omarchy plugin remove omaramp

# 2. (Optional) Clean up cached album art and history
rm -rf ~/.config/omarchy/plugins/omaramp ~/.cache/omaramp

# 3. Restart the desktop shell
omarchy restart shell

⌨️ Shell / IPC Commands

Control Omaramp from your terminal, scripts, or window manager hotkeys:

# Toggle player panel
omarchy-shell shell summon omaramp
omarchy-shell shell toggle omaramp

# Playback controls
omarchy-shell omaramp play
omarchy-shell omaramp pause
omarchy-shell omaramp toggle
omarchy-shell omaramp stop

# Navigation
omarchy-shell omaramp next
omarchy-shell omaramp prev

# Play a stream URL or YouTube link
omarchy-shell omaramp playUrl "https://www.youtube.com/watch?v=..."

📄 License

MIT License © 2026 JoeJoeflyn