Omahub
← All plugins
M

Media Control

by MrDemonc

Omarchy popup media controller widget with artwork, metadata, timeline seek, and MPRIS playback controls

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
6830bba
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:25

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/MrDemonc/omarchy-media-control.git

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
6830bba
Reviewed
1 month ago

The plugin is a standard MPRIS-based media controller for the Omarchy bar. All code is transparent and predictable: QML UI, helper JS for formatting/Metadata handling, and a simple shell installer. The only external host reference is the GitHub URL in the README for cloning the repository, which is documentation-only and not executed. No obfuscation, backdoors, or unexpected network requests are present.

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/MrDemonc/Omarchy-media-control --enable
Desktop #bar

Omarchy Media Control

A native Omarchy (Hyprland + Quickshell) bar widget and popup card for controlling music and video playback in real time via the MPRIS standard.

<p align="center"> <img src="res/media-control.gif" alt="Hardware Tooltip opening on one Omarchy theme, then following a theme change with live CPU and GPU bars" width="360"> </p>

Installation

Option 1:

Once published to GitHub or your Git host:

omarchy plugin add https://github.com/MrDemonc/omarchy-media-control.git --enable
omarchy restart shell

Option 2:

git clone https://github.com/MrDemonc/omarchy-media-control.git
cd omarchy-media-control
./install.sh --enable --restart

✨ Features

  • 🎵 Dynamic Bar Icon:

    • Reacts to playback state (󰎆 / 󰐊 / 󰝚).
    • Left Click: Open / close the popup control window.
    • Middle Click: Instant play / pause.
    • Mouse Wheel: Scroll up / down to skip to next or previous track.
    • Hover Tooltip: Displays current track title and artist.

  • 🎚️ CAVA-Style Audio Visualizer:

    • Animated equalizer bars in the header that bounce to the rhythm of playback.
    • Square corners (radius: 0) strictly aligned with Omarchy's geometric design system.
    • Smoothly settles to a resting state when paused.

  • 💿 Interactive Dual-Style Cover Art:

    • Click on the cover to toggle between:
      1. Standard Mode: Clean rounded rectangle matching Omarchy surface tokens.
      2. Spinning Vinyl Mode: True circular vinyl disc with center spindle hole that continuously spins while playing.
    • Automatic thumbnail extraction for YouTube web videos in browsers (Zen, Firefox, Chrome, Brave).

  • ⏱️ Smart Timeline & Seek Bar:

    • Songs with known duration (Spotify, VLC, local audio): Interactive slider to scrub and seek with live timestamps.
    • Web streams / videos without duration: Progress bar automatically hides for a clean, compact layout.

  • ⏯️ Full MPRIS Playback Controls:

    • Previous (󰒮), Play / Pause (󰐊 / 󰏤), Next (󰒭), and Stop (󰓛).

  • 🔊 Per-App Volume Control:

    • Dedicated slider to adjust player volume or quick-toggle mute with speaker icon.

  • 🔀 Multi-Source Switcher:

    • Easily switch active control between multiple media players (e.g. Spotify + YouTube on browser).

  • 📻 Background Lofi Girl Radio:

    • One-click launch button (󰗃) in the header and empty state to stream the YouTube Lofi Girl live audio directly in the background via mpv (headless, no browser needed).
    • Can be toggled on/off directly from the widget or stopped using the standard Stop button.

  • ⌨️ Keyboard Accessibility:

    • Press <kbd>Esc</kbd> to close the modal instantly.

🎛️ Interaction Cheatsheet

Action Control / Gesture
Open / Close popup Left click on the bar icon
Close popup Press <kbd>Esc</kbd> or click outside
Toggle Cover Style Click on the album artwork (Standard / Spinning Vinyl)
Quick Play / Pause Middle click on the bar icon
Previous / Next Track Mouse scroll up / down on the bar icon
View Current Track Hover over the bar icon (Tooltip)
Seek Timeline Drag progress slider (when duration is available)
Adjust Volume Drag volume slider or click speaker icon to mute
Switch Player Click the source badge dropdown
Toggle Lofi Girl Radio Click the 󰗃 button in header or idle screen

⚙️ Uninstallation

To remove the plugin:

omarchy plugin remove omarchy-media-control
omarchy restart shell