Skip to content

Moon-0xff/gnome-mpris-label

Repository files navigation

alt text

About

This GNOME extension reads metadata information from an mpris compatible player and displays it on the top bar. It works with Spotify, Vlc, Rhythmbox, Chromium based browsers and (probably) any mpris compatible player.

This extension was originally a fork for mheine's gnome spotify label. It quickly spiraled out of control and i ended up replacing or reverting all but a hint of the original code, so i decided to start this repository from scratch.

The idea of supporting all mpris compatible players (and how to do it) comes from this pull request in mheine's extension.

Installation

Using extensions.gnome.org

Install this extension from extensions.gnome.org

This is the recommended way of installing GNOME extensions, the browser plugin will install the extension in one click, and is just as easy to remove or manage.

It requires the installation of a browser plugin and a system package. Visit the page for further instructions.

Using Git and the installation script

  1. Clone this repository: $ git clone https://github.com/Moon-0xff/gnome-mpris-label.git
  2. cd into the directory: $ cd gnome-mpris-label
  3. Checkout the stable branch: $ git checkout stable
  4. Run the installation script: $ sh install.sh

Skip the third step to install the development version.
Warning: the latest development version could be broken or buggy

More info about the installation

The default installation path is: ~/.local/share/gnome-shell/extensions/mprisLabel@moon-0xff.github.com/

This extension (for GNOME 44/43) can be installed by simply copying the repository to the default installation path.

GNOME 45+ compatibility isn't provided directly, it needs to be patched.
The installation script will patch the extension if it detects a gnome-shell version above or equal to 45.
You can patch it manually by running: $ patch < patches/gnome45-compatibility.patch

Recently installed extensions are only available after gnome-shell is reloaded. On Gnome-Wayland is necessary to log out and log back in. On Gnome-Xorg the shell can be reloaded by running r on the 'Run as a command' prompt (default shortcut: Alt+F2).

Contribution

Feel free to submit an issue if you have encountered a bug, want to ask something, want to share an idea for a feature, or something else entirely.

Feel free to submit a pull request for a bug you squashed, a feature you added, or anything you want merged to this repo.

Checkout HACKING.md for a quick guide on editing the source code.