Skip to content

Latest commit

 

History

History
233 lines (182 loc) · 14.5 KB

supported-media-players.md

File metadata and controls

233 lines (182 loc) · 14.5 KB

Supported media players

Note

If your media player is not detected, please visit the troubleshooting page

Overview

Streaming services

                         

Offline media players

                           

Support Table

Media from websites in browsers and Linux are not yet supported

Desktop Application Windows Mac Linux
AIMP ✅ 📝 🔧 ✖️ ...
Amazon Music ✅ 🤕 ✅* ...
Apple Music ...
Apple Podcasts ✖️ ✖️
Cider7 ✖️
Deezer ✅* ...
Dopamine5 ... ...
foobar2000 ✅ 📝 ✖️
Harmonoid ✖️ ...
iTunes8 ✅ 📝 ✖️ ✖️
Jellyfin ✅ 🔧 ... ...
MediaMonkey ✅ 🤕 ✖️ ✖️
mpv ✅ 📝 ✅ 🔧 ...
MusicBee ✅ 📝 ✖️ ✖️
Next-Player2 ✖️ ✖️
Nora3 ✖️ ...
Pocket Casts ✖️ ✖️
Podurama9 ✅ 🔧 ... ...
Qobuz ⚠️ ✖️
Soundcloud4 ... ...
Spotify ...
TIDAL ...
VLC Media Player ✅ 📝 🔧 ... ...
WACUP ✅ 🔧 ✖️ ✖️
Winamp6 ✅ 🔧 ✖️ ✖️
Windows Media Player ✅ 🤕 ✖️ ✖️
Yandex Music ✖️
YouTube Music1 ... ...
YouTube9 ✅ 📝 ... ...
Symbol Meaning
This player is supported
📝 Needs additional configuration, please check the additional notes below
🔧 This player is supported, but only reports basic playback information
🤕 This player has known issues, see below
☑️ This player is supported and should work, but wasn't explicitly tested
⚠️ Does not report any playback information unfortunately
✖️ Not available on this operating system
Not tested or not known to have a desktop application on this operating system
... Not supported yet, but will likely be added in the future

1 Using this unofficial desktop app
2 From the developer "DryForest", link
3 GitHub
4 Official app (only works on Windows 11)
5 GitHub, works with Dopamine version 2 and 3
6 Winamp only works when installed via the WACUP installer
7 Works on Windows 11 and Mac
8 iTunes for Mac only runs on Mac versions older than the ones Music Presence supports
9 Right now this only works by installing it via WebCatalog

Additional notes

MusicBee

MusicBee works well with this plugin: https://github.com/HenryPDT/mb_MediaControl

The installation of such a plugin is required because otherwise MusicBee does not report what it is playing to Windows. Once you have installed and enabled it, Music Presence should detect Music Bee.

foobar2000

While foobar2000 reports basic information out of the box, this plugin will add the album name and a progress bar to your status: https://github.com/ungive/foo_mediacontrol

This is a fork of an old plugin which I have adapted to report missing song information.

AIMP

AIMP requires this plugin to work: https://www.aimp.ru/forum/index.php?topic=63341

Unfortunately this plugin does not report accurate playback information, but everything else seems to work just fine.

VLC

VLC requires this plugin to work: https://github.com/spmn/vlc-win10smtc

At the moment this plugin does not report any cover images, nor an accurate playback position.

iTunes

On Windows you will need to run this helper program for iTunes to report currently playing media to Windows: https://github.com/thewizrd/iTunes-SMTC. After that it should be detected and you should see it in your status.

iTunes on Mac is not supported as all versions for iTunes on Mac are too old.

mpv

On Windows, mpv must either be run with --media-controls=yes or by setting media-controls=yes in your mpv.conf file. Otherwise mpv does not report currently playing media to Windows.

On Mac, you must install and run mpv using an app bundle (file ending with .app), otherwise it cannot be detected at this time. Installing it with brew only installs a command line tool. If you need Music Presence to work with the command line tool only and you don't want to install an app bundle, please open an issue.

If cover images are not showing or the above setting is not available, try updating mpv or installing a development version of mpv.


Players with known issues

These are issues with the media players themselves, not with Music Presence! Affected players are sometimes reporting incorrect song metadata or playback information, we unfortunately can't do much about that.

Also note that the information here was gathered some time ago and might be outdated for some media players. Contributions with updated information are very welcome.

Not working randomly

Some players stop reporting song information arbitrarily at some point.

  • Windows Media Player on Windows

Incorrect song metadata

The following players sometimes report incorrect song information, like a missing artist, a scrambled song name or no information at all, which might cause some songs to not be shown in your status or only with incomplete information.

  • Amazon Music on Windows

Players with only basic playback information

No precise playback position

These players do not report a precise playback position and will only show how much time has elapsed since starting the song, instead of adjusting correctly, depending on which playback position you jump to in the song.

  • Amazon Music on Windows
  • Amazon Music on Mac
  • Deezer on Windows
  • Deezer on Mac
  • foobar2000 on Windows
  • Qobuz on Windows
  • Winamp on Windows
  • WACUP on Windows
  • AIMP on Windows
  • MediaMonkey on Windows
  • VLC on Windows
  • Harmonoid on Windows
  • Jellyfin on Windows

Incorrect playback position timestamp

These media players report a playback position (which might also be imprecise, see above), but they also say e.g. "this playback position is from 10 minutes ago" even though the media just started playing and it should say something like "this playback position is from a few seconds ago". This only becomes a problem when pausing the song and continuing it later, which might report something like "13:04 elapsed" for a song that's 3 minutes long.

  • Deezer on Mac

Missing album cover image

These players do not report the album cover to the operating system.

  • MediaMonkey on Windows
  • VLC on Windows
  • Podurama on Windows