User Guide
For the most part this extension is pretty simple. There are no configuration options.
This is a list of the possible features and functionality of this extension. Not all players expose/support the below features or functionality via MPRIS. If a feature or functionality is not present or is non-functional in this extension for a given player it is because it is not exposed/supported by that player, or it is broken in that player's MPRIS implementation. A player may expose/support several, none or all of the below features or functionality in random combination.
There is no black or whitelisting of the below features or functionality in this extension. If you want a feature or functionality to work in a given player that does not already, you should file a bug report requesting said feature or functionality with that player.
See Here for Known Player Bugs.
In practice that means generally, if a UI element is visible it works and does stuff. Otherwise if it's not visible, well, you can't do whatever it was supposed to do via MPRIS in that player anyway, that's why it's not visible. Keyboard Shortcuts & Mouse Button Actions either work or they don't, again depending on if the Action is exposed/supported by that player via MPRIS. Certain UI elements are natural indications of what Keyboard Shortcuts & Mouse Button Actions are supported. For example, if there is not a volume slider for a player then obviously the volume control Keyboard Shortcuts & Mouse Button Actions are not going to be functional either, but if there is a volume slider then the volume control Keyboard Shortcuts & Mouse Button Actions will also be functional, and so on. Basically if you can do it in the UI you can do it with a Keyboard Shortcut and/or Mouse Button Action. This extension is designed to be usable without a mouse.
Above is an example of three different players that expose/support three different sets of features/functionalities.
The indicator icon features a tooltip with the active player's current track info and playback status.
The sort order to determine the active player is:
focused > playbackStatus > userTime > statusTime > mostRecentlyAddedMouse Button Actions and Keyboard Shortcuts affect the active player.
| Mouse Button Actions | Action |
|---|---|
| Secondary Click | Raise/Minimize Toggle |
| Mouse Wheel Click | Play/Pause/Stop Toggle |
| Forward Click | Volume Down |
| Back Click | Volume Up |
| Mouse Wheel Up | Skip Back |
| Mouse Wheel Down | Skip Forward |
| Mouse Wheel Left | Volume Down |
| Mouse Wheel Right | Volume Up |
| Keyboard Shortcuts | Action |
| Ctrl+Space | Play/Pause/Stop Toggle |
| Ctrl+Left | Skip Back |
| Ctrl+Right | Skip Forward |
| Ctrl+Up | Volume Up |
| Ctrl+Down | Volume Down |
| Ctrl+Return | Mute Toggle |
| Shift+Left | Shuffle Toggle |
| Shift+Right | Cycle Repeat Modes |
| Shift+Return | Raise/Minimize Toggle |
Mouse Button Actions and Keyboard Shortcuts are identical to the Indicator icon, except of course that they only affect that player.
| Mouse Button Actions | Action |
|---|---|
| Secondary Click | Raise/Minimize Toggle |
| Mouse Wheel Click | Play/Pause/Stop Toggle |
| Forward Click | Volume Down |
| Back Click | Volume Up |
| Mouse Wheel Up | Skip Back |
| Mouse Wheel Down | Skip Forward |
| Mouse Wheel Left | Volume Down |
| Mouse Wheel Right | Volume Up |
| Keyboard Shortcuts | Action |
| Ctrl+Space | Play/Pause/Stop Toggle |
| Ctrl+Left | Skip Back |
| Ctrl+Right | Skip Forward |
| Ctrl+Up | Volume Up |
| Ctrl+Down | Volume Down |
| Ctrl+Return | Mute Toggle |
| Shift+Left | Shuffle Toggle |
| Shift+Right | Cycle Repeat Modes |
| Shift+Return | Raise/Minimize Toggle |
In addition the close/quit button allows you to quit the player if supported by the player.
Not all players support shuffle/repeat functionality.
| Mouse Button Actions | Action |
|---|---|
| Secondary Click | Play/Pause/Stop Toggle |
| Mouse Wheel Up | Skip Back |
| Mouse Wheel Down | Skip Forward |
| Mouse Wheel Left | Volume Down |
| Mouse Wheel Right | Volume Up |
| Keyboard Shortcuts | Action |
| Ctrl+Space | Play/Pause/Stop Toggle |
| Ctrl+Left | Skip Back |
| Ctrl+Right | Skip Forward |
| Ctrl+Up | Volume Up |
| Ctrl+Down | Volume Down |
| Ctrl+Return | Mute Toggle |
| Shift+Left | Shuffle Toggle |
| Shift+Right | Cycle Repeat Modes |
| Shift+Return | Raise/Minimize Toggle |
The volume controls function much like the system volume controls in addition to the added Mouse Button Action(s).
| Mouse Button Actions | Action |
|---|---|
| Secondary Click | Mute Toggle |
The Playlists & Tracklist Menus function how you would expect.
Clicking on a Track or Playlist tells the player to go to that Track or Activate that Playlist.
Most players do not support playlists or tracklists.