Media Player Setup

This guide covers how to set up Music Presence with your media player.

Supported media players¶

Check the list of supported media players, to know if your media player is supported.

If your media player is not listed, then follow the instructions below on how you can help with adding support for it to Music Presence.

Minimum requirements¶

For Music Presence to detect media playback, other applications must report information about what media they are playing to your operating system. You can see if other applications do this, by checking the media control interface of your device.

If the media does not show up, refer to the next section. Make sure you are playing something, paused media may not always appear.

Media control interfaces

Media player configuration¶

Depending on the media player you are using, you may need to install a plugin, run a helper program or enable a specific setting. Refer to the table below for instructions.

Make sure to select the correct operating system by clicking on the respective tab.

 Windows Mac Linux

Player		Instructions
	AIMP	Install the Windows Media Control plugin.
	Feishin	Switch to the web backend, then go to Settings -> Hotkeys and enable Media Session. Note that Music Presence can only identify Feishin as mpv, when you use the mpv backend.
	foobar2000	Install the foo_mediacontrol plugin. Click Releases to find all downloads. Alternatively you can also enable Windows Universal Volume Control under advanced preferences, but foobar2000 will not report the album name or the track duration then.
	iTunes	You need to run the iTunes-SMTC helper program alongside Music Presence. You can download it from the Releases or the Windows Store
	MPC-HC	Under Player -> User Interface -> Windows Integration enable Control via Windows UI (SMTC). If you don't have this setting, make sure to use this updated fork of MPC-HC: clsid2/mpc-hc.
	mpv	mpv must either be run with the --media-controls=yes command line flag or by setting media-controls=yes in mpv.conf.
	MusicBee	Install the mb_MediaControl plugin. Click Releases to find all downloads. After importing it into MusicBee, make sure the information window shows version 1.0.4 or newer.
	VLC	Install the vlc-win10smtc plugin.
	Winamp	Install the gen_smtc plugin.
	Windows Media Player Legacy	Windows-Media-Player-Discord-RPC is a 2-in-1 program that allows Windows Media Player to be detected by Music Presence while it's running and also provides its own Discord RPC implementation.

Player		Instructions
	iTunes	iTunes is not supported on Mac. Use Apple Music instead.
	mpv	You must install and run mpv using an .app bundle. mpv cannot be detected when run as a plain binary from the command line.

Player		Instructions
	MusicBee	If you run MusicBee under Wine, install the mb_MPRISBee plugin.

Media players with known issues¶

Some media players are known to not report what they are playing or are known to report inaccurate information. If you use one of these players, consider contacting the developer of that media player, so they can improve its integration with the system.

 Windows Mac Linux

Player		Instructions
	Amazon Music	Amazon Music does not report any album cover image and sometimes reports very inaccurate or scrambled song metadata.
	Qobuz	Qobuz does not report what it is playing anymore since a past update. You can try downgrading or patching it (this may violate Qobuz ToS, use at your own risk).
	TIDAL	TIDAL does not report the album name of the playing song. If the TIDAL API is enabled for Discord Presence, the album name can only be guessed and may sometimes be incorrect.
	Windows Media Player	Windows Media Player sometimes does not report any album cover image and tends to stop reporting what it is playing after playing a few songs.

Player		Instructions
	Qobuz	Qobuz does not report what it is playing on Mac.

Player		Instructions
	Strawberry	If you installed Strawberry via Flatpak, then album covers may not show up in your Discord status. This is a bug in the Flatpak-version of Strawberry. You need to run Strawberry natively instead, until the bug is fixed.

Websites and browser support¶

On Windows and Mac, you currently need to use the desktop application for the media player or streaming service you are using, as websites are not supported yet. The following table contains a list of supported official and third-party desktop applications.

 Windows Mac Linux

Player		Instructions
	Apple Music	Install the Apple Music app from the Microsoft Store.
	SoundCloud	Install the SoundCloud app from the Microsoft Store.
	YouTube Music	Third-party Pear Desktop works well with Music Presence.
		For these and other streaming services, download the desktop application from the official website.

Player		Instructions
	Apple Music	Install the Apple Music app from the App Store.
	SoundCloud	Third-party Nuage is a third-party client for SoundCloud.
	YouTube Music	Third-party Pear Desktop works well with Music Presence.
		For these and other streaming services, download the desktop application from the official website.

Player		Instructions
	Firefox	Websites and streaming services can be detected when opened in Firefox or a Firefox-based browser, like LibreWolf or Zen Browser, if they are supported.
	Apple Music	Third-party Sidra is a third-party client for Apple Music.
	Deezer	Third-party Deezer for Linux is a third-party client for Deezer.
	Qobuz	Third-party QBZ is a third-party client for Qobuz. Unlike the official app for Windows and Mac, this client is fully compatible with Music Presence.
	Spotify	Download Spotify from spotify.com/download/linux.
	TIDAL	Third-party Tidal Hi-Fi and High Tide are third-party clients for TIDAL.
	YouTube Music	Third-party Pear Desktop is a third-party client for YouTube Music.

Multimedia and radio players¶

Discord Presence is disabled by default for multimedia players, radio players and any other media players that may report personal information or details about your location. You have to enable these explicitly, read Player Controls to find out how.

Adding support for a media player¶

If your media player is not detected, despite fulfilling the minimum requirements, support may not have been added yet. Follow these instructions to help:

1. Open the Music Presence app
2. Play something with your media player and let it play
3. Click the Music Presence icon in your tray menu. Where is this?
4. Click on "Help" and then on "Submit detected media players"
5. A GitHub issue opens. Submit it and you'll receive a reply within at most a few days

If you do not have a GitHub account, you can join the Discord server instead and leave a message that contains the URL that opened in your browser.

Resources¶

Debugging a media player¶

Support message template¶

Information for developers¶