Skip to content

Repository files navigation

BerryControl

GitHub Downloads (specific asset, all releases)

A small GTK/X11 controller for any MPRIS-compatible media player.

Features

  • Minimal floating media widget for MPRIS-compatible players, including browsers and VLC
  • Automatically discovers available MPRIS players
  • MPRIS state tracking for title and playback state
  • Graceful unavailable/connecting/empty-state UI behavior
  • Persistent window position in the user config directory
  • Native Alt+drag window movement when GTK is available
  • Edit window colours and stuff via .config/berrycontrol/window.json file
  • Or the Settings... Why do I do this to myself
  • System tray icon with window size reset, Settings, and Quit options

Install

Dependencies are X11, D-Bus, Python3.10+, PyGObject, GTK3, and AyatanaAppIndicator3.

To build the package:

pyinstaller --name berrycontrol --windowed --add-data "assets:assets" --noconfirm main.py

To install the desktop entry system-wide:

sudo cp berrycontrol.desktop /usr/share/applications/

Or for user-only:

cp berrycontrol.desktop ~/.local/share/applications/

Notes

I couldn't find any simple floating media controllers for x11 (they all seem to be designed for Wayland), so I made one.
And then overengineered it into oblivion because of course I did :)
Enjoy I guess.

About

A small GTK/X11 controller for the MPRIS interface.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages