You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Right-click now cycles through active players instead of opening rofi menu
- Removes rofi dependency
- Updated README to reflect cycling functionality
- Player cycling persists selection across sessions
Copy file name to clipboardExpand all lines: README.md
+37-18Lines changed: 37 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,20 +21,20 @@ Synced lyrics in tooltip:
21
21

22
22
23
23
It features:
24
-
1. Progress bar
25
-
2. Tooltip that displays title, author and album
26
-
3. Synced lyrics in tooltip
27
-
4. Album cover art (click to zoom)
28
-
5. Optional notification on song change
29
-
6. Click to play/pause, scroll up/down to scroll up/down on the playlist
24
+
1. Multi-player support (Firefox, Chrome, Chromium, Thorium, Spotify, and more)
25
+
2. Right-click to cycle through active players
26
+
3. Progress bar
27
+
4. Tooltip that displays title, author and album
28
+
5. Synced lyrics in tooltip
29
+
6. Album cover art (click to zoom)
30
+
7. Optional notification on song change
31
+
8. Click to play/pause, scroll up/down for next/previous track
30
32
31
33
## Requirements
32
34
33
-
[playerctl](https://github.com/altdesktop/playerctl) must be installed.
34
-
35
-
The default configuration use Nerd Fonts, so it requires waybar to use a Nerd Font.
36
-
37
-
The default configuration use [feh](https://github.com/derf/feh) to open the album art image.
35
+
-[playerctl](https://github.com/altdesktop/playerctl) must be installed
36
+
- The default configuration uses Nerd Fonts, so it requires waybar to use a Nerd Font
37
+
- The default configuration uses [feh](https://github.com/derf/feh) to open the album art image
38
38
39
39
## Install
40
40
@@ -67,9 +67,13 @@ The default configuration use [feh](https://github.com/derf/feh) to open the alb
67
67
pip3 install -r requirements.txt
68
68
```
69
69
70
-
1. You need to find the name of your player. To do so, run `playerctl --list-all` while your player is running.
70
+
1. You can configure which players to support by editing `"$HOME/.config/waybar/waybar-mediaplayer/src/config.json`. The default configuration supports Firefox, Chrome, Chromium, Thorium, and Spotify:
71
71
72
-
1. Open `"$HOME/.config/waybar/waybar-mediaplayer/src/config.json` and change `player_name` with the name of your player.
To find available players on your system, run `playerctl --list-all` while your media player is running. You can add or remove players from this list as needed.
73
77
74
78
1. Put the following in `$HOME/.config/waybar/config`:
75
79
@@ -90,6 +94,7 @@ The default configuration use [feh](https://github.com/derf/feh) to open the alb
@@ -110,7 +115,11 @@ The default configuration use [feh](https://github.com/derf/feh) to open the alb
110
115
111
116
1. Start waybar using the wrapper script `start_waybar`.
112
117
113
-
The mediaplayer should work. Click on the progress bar to start/stop playing, and scroll on it to change song.
118
+
The mediaplayer should work with the following controls:
119
+
- **Left click**: Play/pause
120
+
- **Right click**: Cycle through active players
121
+
- **Scroll up**: Next track
122
+
- **Scroll down**: Previous track
114
123
115
124
## Update
116
125
@@ -121,6 +130,14 @@ git pull
121
130
122
131
## Personalization
123
132
133
+
### Multiple Players
134
+
135
+
The widget supports monitoring multiple media players simultaneously. Right-click on the widget to cycle through all available players. The selected player becomes the active player for controls (play/pause, next, previous). Your selection persists across sessions.
136
+
137
+
If no player is selected, the widget automatically uses the first available player from your configured list.
138
+
139
+
### Other Options
140
+
124
141
To disable notifications, put `is_notification=false` in `config.json`.
125
142
126
143
To change widget's length, set `min-length` and `max-length` in `$HOME/.config/waybar/config`, and set `widget_length` in `$HOME/.config/waybar/waybar-mediaplayer/src/config.json`. These 3 variables MUST be set to the same value.
@@ -131,19 +148,21 @@ If you change the colors of the bar in `$HOME/.config/waybar/waybar-mediaplayer/
131
148
132
149
## Troubleshooting
133
150
134
-
### Firefox users
151
+
### Browser Support (Firefox, Chrome, etc.)
152
+
153
+
Browsers with MPRIS support are now natively supported. Firefox, Chrome, Chromium, and Thorium work out of the box.
135
154
136
-
Although Firefox reports MPRIS metadata, the metadata it reports is not sufficient, as it doesn't report song's length. Please install the [Plasma Integration](https://addons.mozilla.org/en-US/firefox/addon/plasma-integration) add-on and use `plasma-browser-integration` as `player_name` in `$HOME/.config/waybar/waybar-mediaplayer/src/config.json`.
155
+
**Note for Firefox users**: If you experience issues with the progress bar (Firefox may not always report song length), you can optionally install the [Plasma Integration](https://addons.mozilla.org/en-US/firefox/addon/plasma-integration) add-on for better metadata support. If using this add-on, add `"plasma-browser-integration"` to your `player_name` array in `config.json`.
137
156
138
-
To have album art, make sure to set `convert_to_jpeg` to `true` in `$HOME/.config/waybar/waybar-mediaplayer/src/config.json` (this option decreases performance, don't use it if not necessary).
157
+
For album art from browsers, you may need to set `convert_to_jpeg` to `true` in `config.json` (this option may decrease performance slightly).
139
158
140
159
### Me progress bar doesn't work
141
160
142
161
It's likely cause by the player not reporting song length or position back to us. Run `$HOME/.config/waybar/waybar-mediaplayer/src/mediaplayer -vvv` to debug.
143
162
144
163
### Player reports its name with instance number
145
164
146
-
If the player reports an instance after its name, please provide only the player name without the instance number. For example, [kew](https://github.com/ravachol/kew) may report itself as `kew123456`, where `123456` is an instance number which will change with different runs of `kew`. In this case, we report only `kew` without the instance number. This software will check whether the reported player name _starts_ with the name you provide to bind the correct player.
165
+
This is handled automatically. If a player reports an instance number after its name (e.g., `spotify.instance12345`), you only need to configure the base player name (e.g., `"spotify"`) in `config.json`. The software will automatically match any player whose name starts with the configured name.
0 commit comments