# Supported media players

> [!WARNING]
> This page is not kept up to date.
> You can find an updated overview [here](https://musicpresence.pocha.moe/),
> which is a site created by a community member.
> Thank you [@mercurialworld](https://github.com/mercurialworld)!
> The [additional notes](#additional-notes) below still apply though.

> [!NOTE]
> If your media player is not detected,
please visit the [**troubleshooting**](./troubleshooting.md) page

## Overview

**Streaming services**

<span><a href="https://tidal.com"><img title="TIDAL" alt="" height="48" src="https://live.musicpresence.app/v2/tidal.ico"></a></span>&nbsp;
<span><a href="https://spotify.com"><img title="Spotify" alt="" height="48" src="https://live.musicpresence.app/v2/spotify.ico"></a></span>&nbsp;
<span><a href="https://www.deezer.com"><img title="Deezer" alt="" height="48" src="https://live.musicpresence.app/v2/deezer.ico"></a></span>&nbsp;
<span><a href="https://www.amazon.com/music"><img title="Amazon Music" alt="" height="48" src="https://live.musicpresence.app/v2/amazon-music.ico"></a></span>&nbsp;
<span><a href="https://music.apple.com"><img title="Apple Music" alt="" height="48" src="https://live.musicpresence.app/v2/apple-music.ico"></a></span>&nbsp;
<span><a href="https://th-ch.github.io/youtube-music/"><img title="YouTube Music (Unofficial Desktop)" alt="" height="48" src="https://live.musicpresence.app/v2/youtube-music.ico"></a></span>&nbsp;
<span><a href="https://apps.microsoft.com/detail/9nvjbt29b36l"><img title="SoundCloud" alt="" height="48" src="https://live.musicpresence.app/v2/soundcloud.ico"></a></span>&nbsp;
<span><a href="https://pocketcasts.com/"><img title="Pocket Casts (Podcasts)" alt="" height="48" src="https://live.musicpresence.app/v2/pocketcasts.ico"></a></span>&nbsp;
<span><a href="https://en.wikipedia.org/wiki/Yandex_Music"><img title="Yandex Music" alt="" height="48" src="https://live.musicpresence.app/v2/yandex-music.ico"></a></span>&nbsp;
<span><a href="https://cider.sh"><img title="Cider (Apple Music)" alt="" height="48" src="https://live.musicpresence.app/v2/cider.ico"></a></span>&nbsp;
<span><a href="https://youtube.com"><img title="YouTube" alt="" height="48" src="https://live.musicpresence.app/v2/youtube.ico"></a></span>&nbsp;
<span><a href="https://podurama.com/"><img title="Podurama" alt="" height="48" src="https://live.musicpresence.app/v2/podurama.ico"></a></span>&nbsp;

**Offline media players**

<span><a href="https://www.foobar2000.org"><img title="foobar2000" alt="" height="48" src="https://live.musicpresence.app/v2/foobar2000.ico"></a></span>&nbsp;
<span><a href="https://www.getmusicbee.com"><img title="MusicBee" alt="" height="48" src="https://live.musicpresence.app/v2/musicbee.ico"></a></span>&nbsp;
<span><a href="https://getwacup.com/"><img title="Winamp (installed via WACUP)" alt="" height="48" src="https://live.musicpresence.app/v2/winamp.ico"></a></span>&nbsp;
<span><a href="https://getwacup.com/"><img title="WACUP" alt="" height="48" src="https://live.musicpresence.app/v2/wacup.ico"></a></span>&nbsp;
<span><a href="https://www.videolan.org/vlc"><img title="VLC Media Player" alt="" height="48" src="https://live.musicpresence.app/v2/vlc.ico"></a></span>&nbsp;
<span><a href="https://www.aimp.ru"><img title="AIMP" alt="" height="48" src="https://live.musicpresence.app/v2/aimp.ico"></a></span>&nbsp;
<span><a href="https://www.mediamonkey.com"><img title="MediaMonkey" alt="" height="48" src="https://live.musicpresence.app/v2/mediamonkey.ico"></a></span>&nbsp;
<span><a href="https://en.wikipedia.org/wiki/Windows_Media_Player_(2022)"><img title="Windows Media Player" alt="" height="48" src="https://live.musicpresence.app/v2/windows-media-player.ico"></a></span>&nbsp;
<span><a href="https://github.com/Sandakan/Nora"><img title="Nora Music" alt="" height="48" src="https://live.musicpresence.app/v2/nora.ico"></a></span>&nbsp;
<span><a href="https://apps.microsoft.com/detail/9nblggh67n4f"><img title="Next-Player (DryForest)" alt="" height="48" src="https://live.musicpresence.app/v2/next-player.ico"></a></span>&nbsp;
<span><a href="https://github.com/digimezzo/dopamine"><img title="Dopamine" alt="" height="48" src="https://live.musicpresence.app/v2/dopamine.ico"></a></span>&nbsp;
<span><a href="https://harmonoid.com"><img title="Harmonoid" alt="" height="48" src="https://live.musicpresence.app/v2/harmonoid.ico"></a></span>&nbsp;
<span><a href="https://www.apple.com/de/itunes"><img title="iTunes" alt="" height="48" src="https://live.musicpresence.app/v2/itunes.ico"></a></span>&nbsp;
<span><a href="https://mpv.io"><img title="mpv" alt="" height="48" src="https://live.musicpresence.app/v2/mpv.ico"></a></span>&nbsp;

## Support Table

> Media from websites in browsers and Linux are not yet supported

| Desktop Application       |                   Windows                   |          Mac <15.4          |                                Mac >=15.4                                |          Linux           |
|---------------------------|:-------------------------------------------:|:---------------------------:|:------------------------------------------------------------------------:|:------------------------:|
| AIMP                      |    :white_check_mark: :pencil: :wrench:     |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         |           ...            |
| Amazon Music              | :white_check_mark: :face_with_head_bandage: |     :white_check_mark:*     |                         :heavy_multiplication_x:                         |           ...            |
| Apple Music               |             :white_check_mark:              |     :white_check_mark:      |                            :white_check_mark:                            |           ...            |
| Apple Podcasts            |          :heavy_multiplication_x:           |     :white_check_mark:      |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Cider<sup>7</sup>         |             :white_check_mark:              |     :white_check_mark:      |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Deezer                    |             :white_check_mark:              |     :white_check_mark:*     |                         :heavy_multiplication_x:                         |           ...            |
| Dopamine<sup>5</sup>      |             :white_check_mark:              |             ...             |                                   ...                                    |           ...            |
| foobar2000                |         :white_check_mark: :pencil:         |     :white_check_mark:      |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Harmonoid                 |             :white_check_mark:              |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         |           ...            |
| iTunes<sup>8</sup>        |         :white_check_mark: :pencil:         |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Jellyfin                  |         :white_check_mark: :wrench:         |             ...             |                                   ...                                    |           ...            |
| MediaMonkey               | :white_check_mark: :face_with_head_bandage: |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| mpv                       |             :white_check_mark:              | :white_check_mark: :wrench: |                         :heavy_multiplication_x:                         |           ...            |
| MusicBee                  |         :white_check_mark: :pencil:         |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Next-Player<sup>2</sup>   |             :white_check_mark:              |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Nora<sup>3</sup>          |             :white_check_mark:              |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         |           ...            |
| Pocket Casts              |             :white_check_mark:              |     :white_check_mark:      |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Podurama<sup>9</sup>      |         :white_check_mark: :wrench:         |             ...             |                                   ...                                    |           ...            |
| Soundcloud<sup>4</sup>    |             :white_check_mark:              |             ...             |                                   ...                                    |           ...            |
| Spotify                   |             :white_check_mark:              |     :white_check_mark:      |                            :white_check_mark:                            |           ...            |
| TIDAL                     |             :white_check_mark:              |     :white_check_mark:      | soon [#211](https://github.com/ungive/discord-music-presence/issues/211) |           ...            |
| VLC Media Player          |    :white_check_mark: :pencil: :wrench:     |             ...             |                                   ...                                    |           ...            |
| WACUP                     |         :white_check_mark: :wrench:         |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Winamp<sup>6</sup>        |         :white_check_mark: :wrench:         |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Windows Media Player      | :white_check_mark: :face_with_head_bandage: |  :heavy_multiplication_x:   |                         :heavy_multiplication_x:                         | :heavy_multiplication_x: |
| Yandex Music              |             :white_check_mark:              |       :grey_question:       |                             :grey_question:                              | :heavy_multiplication_x: |
| YouTube Music<sup>1</sup> |             :white_check_mark:              |             ...             | soon [#212](https://github.com/ungive/discord-music-presence/issues/212) |           ...            |
| YouTube<sup>9</sup>       |         :white_check_mark: :pencil:         |             ...             |                                   ...                                    |           ...            |

|          Symbol          | Meaning                                                                        |
|:------------------------:|--------------------------------------------------------------------------------|
|    :white_check_mark:    | This player is supported                                                       |
|         :pencil:         | Needs additional configuration, please check the additional notes below        |
|         :wrench:         | This player is supported, but only reports basic playback information          |
| :face_with_head_bandage: | This player has known issues, see below                                        |
| :ballot_box_with_check:  | This player is supported and should work, but wasn't explicitly tested         |
|        :warning:         | Does not report any playback information unfortunately                         |
| :heavy_multiplication_x: | Not available on this operating system                                         |
|     :grey_question:      | 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                      |

<sup>1</sup> Using [this](https://github.com/th-ch/youtube-music) unofficial desktop app  
<sup>2</sup> From the developer "DryForest", [link](https://apps.microsoft.com/detail/9nblggh67n4f)  
<sup>3</sup> [GitHub](https://github.com/Sandakan/Nora)  
<sup>4</sup> [Official app](https://apps.microsoft.com/detail/9nvjbt29b36l) (only works on Windows 11)  
<sup>5</sup> [GitHub](https://github.com/digimezzo/dopamine), works with Dopamine version 2 and 3  
<sup>6</sup> Winamp only works when installed via the [WACUP](https://getwacup.com) installer  
<sup>7</sup> Works on Windows 11 and Mac  
<sup>8</sup> iTunes for Mac only runs on Mac versions older than the ones Music Presence supports  
<sup>9</sup> Right now this only works by installing it via [WebCatalog](https://webcatalog.io)

## 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.

### Winamp

For classic Winamp you might need this plugin,
for the player to report the currently playing media to Windows:

https://github.com/NanMetal/gen_smtc

### 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](https://github.com/ungive/discord-music-presence/issues).

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
- Amazon Music on Windows