Skip to content
Control any MPRIS compliant player from gnome-shell panel
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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?


MprisControl (playing)


MprisControl (menu)


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:


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

# cp MprisControl\ /usr/share/gnome-shell/extensions


$ cp MprisControl\ ~/.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 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;


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

Something went wrong with that request. Please try again.