Skip to content

YouTube Music Provider Preview image

Music Assistant has support for Youtube Music. Contributed and maintained by MarvinSchenkel

DISCLAIMER

Please note that Youtube does not offer an official API to retrieve data and streams. This means that everything is built on a best-effort basis. Unexpected behavior will occur whilst using this provider. For this reason if you have another streaming provider you may find it more convenient to use that instead of this one.

Note

Free accounts are NOT supported.

Features

The highest available stream from Youtube Music will be selected for playback (similar to configuring 'high' in the web-app). This then gets re-encoded by MA to a lossless FLAC.

Configuration

Music Assistant uses OAuth for Youtube Music, which means login is accomplished as is done on Gmail (for example). To add the Youtube Music provider to MA:

  • Navigate to 'Settings'
  • Under Music Providers, click 'Add new', select 'Youtube Music' and click 'Authenticate with Youtube Music'
  • A new window will open. Ignore the code and click 'Next'
  • Login with your gmail account
  • Optionally choose a brand account
  • Click 'Allow'
  • You can now manually close the tab to return to Music Assistant
  • Click 'Save'

Known Issues / Notes

  • This provider mimics YouTube Music. Do not expect to see the same search results as you see if using YouTube.
  • There is no support for the disc and track number in album tracks listings. Currently, the disc number is always 0 and the track number is the order number in which the tracks were returned by Youtube Music. This should generally give the desired result, but could mess up multi-disc albums.
  • Whether music videos are selected for playback fully depends on what you are playing. If you have saved a specific album in your library, then that exact version will show up in MA and thus you will have the album version. However, if you start a radio on, for example, a playlist, then Youtube Music decides which songs will be played in a 'dynamic radio' playlist which could include videos.
  • Uploaded Music should be able to be found when it is in a playlist. If it's just a single track being searched for then it may not be found, since often those uploaded songs don't have proper metadata. It will be hard to find them via the UI in MA.
  • Some low quality artwork can be expected when using this provider. YTM is very inconsistent when it comes to delivering thumbnails. When a Playlist or album is retrieved, the thumbs for the tracks are usually in low quality for all songs. However, when a single track is played the HQ version should be displayed. This provider tries to work around the problem for albums and playlists by loading details for the next enqueued track, but some low quality album art is still expected to be encountered.