Skip to content
Control any MPRIS compliant player from gnome-shell panel
JavaScript
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
MprisControl@zdyb.tk
MprisControl_menu.png
MprisControl_playing2.png
README.rst

README.rst

What is MprisControl?

MprisControl is a gnome-shell extension that allows controling any MPRIS compliant player with (literally) one click. The extension places an icon on gnome-shell Main Panel which indicates playback status of currently running media player. Middle-clicking the icon toggles play/pause. Left- or right- -clicking shows menu with standard playback control buttons.

What it looks like?

Everybody loves screenshots, right?

Playing:

MprisControl (playing)

Menu:

MprisControl (menu)

Disclaimer

As I couldn't find any real documentation for writing gnome-shell extensions, I based my code on better or worse snippets and tutorials found on internet. Some of the sources are mentioned below:

Instalation

The MprisControl@zdyb.tk directory should be copied to /usr/share/gnome-shell/extensions or ~/.local/share/gnome-shell/extensions/:

# cp MprisControl\@zdyb.tk /usr/share/gnome-shell/extensions

or:

$ cp MprisControl\@zdyb.tk ~/.local/share/gnome-shell/extensions/

If you're using other media player and you know it is MPRIS compliant, you can add it's name to SUPPORTED_PLAYERS in MprisControl@zdyb.tk/extension.js file:

const SUPPORTED_PLAYERS = ["your_player_here", "rhythmbox", "banshee"];

Moreover, if you want the indicator to be shown even though there is no player running, change the HIDE_DISCONNECTED property to false in the same file:

const HIDE_DISCONNECTED = false;

License

Copyright 2011 Aleksander Zdyb

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Something went wrong with that request. Please try again.