Since version 1.05 O!MPD supports Tidal. Here you find some basic information how to use it.

First of all: this feature is based on unofficial API (mostly gained by reverse engineering) and is not in any way supported by Tidal. It means it can stop working some day.

Basic settings

To use this feature you need Tidal account (Premium or HiFi). You also need right token. Token is the biggest problem – some time ago Tidal started to ban well-known tokens. Only some of them are still working. To get token you can try method described here https://github.com/lucaslg26/TidalAPI – but this probably is not working anymore. Other places are: https://github.com/tamland/python-tidal or https://github.com/yaronzz/Tidal-Media-Downloader – you need to dig into the code. Or just try to find it in Internet.

When you get above, you can go to include/config.inc.php to section Tidal and set username/password for your Tidal account and token. This lets you see data from Tidal in search results (artists/albums/tracks):

or Artist View (artist bio/albums from tidal/top 10 tracks from Tidal):

When your token is incorrect, you will see error message like:


In this case you need to use another token.

Streaming methods

The simplest method to play tracks from Tidal is using ‘direct’ play – in this case O!MPD gets track url from Tidal and sends stream to mpd. To use this method you need to set $cfg['tidal_direct'] to true (this is default setting). You can also set the quality of stream $cfg['tidal_audio_quality']:
LOW – 96kbps, AAC
HIGH – 320kbps, AAC
LOSSLESS – lossless codec: FLAC or ALAC, depending on token

LOSSLESS requires right token: for some tokens audio stream is encrypted and will not play in mpd.
MQA is not supported.

Instead of using ‘direct’ method, you can use mpd Tidal plugin or upmpdcli Tidal plugin. To use them you need to set $cfg['tidal_direct'] to false and properly configure mpd or upmpdcli config files.

If you want to use mpd Tidal plugin your mpd must be in version >= 0.21. You also have to properly configure plugin ‘tidal‘ in mpd.conf (valid username/password/token).

If you want to use upmpdcli you have to set $cfg['upmpdcli_tidal']. Basically it consists of ip address of computer where upmpdlci is installed, port number and some control string, e.g.:
All you have to change in above url is ip address and port. Port should be the same as plgmicrohttpport in /etc/upmpdcli.conf

Playing music from Tidal

Once everything is properly configured you can play music from Tidal the usual way you do it in O!MPD. Albums and tracks act as if they were on your local library: you can add them to playlist, insert, search for lyrics, search info about album, etc.

Album view for album from Tidal (in discography browser you will find albums from local library):

All features for tracks (like adding to Favorites or Favorites playlists) also work:

You can also use Now Playing -> Add to add tracks or albums from Tidal to playing list. Just copy album or track link from Tidal web page or app:

which gives:


for album or:


for track and paste it into File/stream field:

For albums you can also use url address from address field of your web browser:

Then click Add and in a while tracks will appear on your playlist.

Tidal user playlists

O!MPD can play user-created playlists from Tidal. They are available in Favorites:

You can play them, view the tracks on them but it’s not possible to edit them.

Leave a Reply

Your email address will not be published. Required fields are marked *