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.
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 are not going to be functional either, but if there is a volume slider then the volume control Keyboard Shortcuts 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.
See Here for Known Player Bugs.
Mouse Button Actions and Keyboard Shortcuts affect the active player (the player who's icon is shown in the panel).
The sort order to determine the active player is:
focused > playbackStatus > userTime > statusTime > playerName > mostRecentlyAdded| Mouse Button Actions | Action |
|---|---|
| Secondary Click | Raise/Minimize Toggle |
| Mouse Wheel Click | Play/Pause/Stop Toggle |
| Mouse Wheel Up | Skip Back |
| Mouse Wheel Down | Skip Forward |
| 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 |
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 |
| Mouse Wheel Up | Skip Back |
| Mouse Wheel Down | Skip Forward |
| 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 |
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 |
| 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 |
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 tell the player to go to that Track or Activate that Playlist.
Most players do not support playlists or tracklists.