Youtube Music OBS Widget

Youtube Music OBS (Streamlabs OBS) widget (formerly Google Youtube Music OBS Widget)

This widget is using Youtube Music Desktop Player API for displaying informations about song that is being played.

Update 5.2.2024

Updated data collection to work with new YTM Desktop Player version. If the widget doesn't work for you, please update your YTM Desktop Player to the latest version. Don't forget to enable Companion server in the Settings > Integrations.

Update 24.12.2022

Widget now works with Youtube Music Dekstop Player (https://ytmdesktop.app/)

Features

• Your viewers can see what are you listening to
• Easy setup
• Responsive
• Doesn't need server to run, everything is HTML and Javascript
• Possible to hide/change some elements, for example progress-bar, disable background, disable album image, position album image to right, circle progressbar
• Text-only version
• no-CSS version

Requirements:

• Youtube Music Desktop App (https://ytmdesktop.app/)
• Enable Companion server (YTMDesktop > Settings > Integrations > Companion server), image: https://imgur.com/a/f39ibMA)
• In Companion server settings:
  • Enable Allow browser communication
  • Enable companion authorization (just for the first time you use the widget)*

Installation steps for OBS (Streamlabs OBS)

1. Add source
2. Browser source
3. URL: https://topik.github.io/youtube-music-obs-widget/

• in case you want to run widget on your local machine, clone this repository, check Local file and link the file index.html

Parameters

You can use multiple parameters (separated by + sign) for disabling/enabling some features.

Parameter	Information	Usage
right	Puts album image to the right side (default left)	index.html?features=right
disable-progressbar	Disables bottom progressbar	index.html?features=disable-progressbar
disable-albumimage	Disable album image	index.html?features=disable-albumimage
transparent-background	Disable background, set background as transparent	index.html?features=transparent-background
circle-progressbar	Disable progressbar, use circle around album image as progressbar	index.html?features=circle-progressbar
disable-time	Disable timer above progressbar	index.html?features=disable-time
album-spin	Spin the album image while playing	index.html?features=album-spin
not-hide-on-pause	Still display the song info while pausing	index.html?features=not-hide-on-pause
blink-pause	Show a pause icon over the album image. Note that not-hide-on-pause is required for this feature.	index.html?features=blink-pause

You can combine multiple parameters together, for example for transparent background and circle progress bar, you will use: index.html?features=transparent-background+circle-progressbar

Examples

Basic setup

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html
Width: 400
Height: 120

Disabled timer and progressbar

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html?features=disable-time+disable-progressbar
Width: 400
Height: 120

Enable circle progressbar (around album image)

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html?features=circle-progressbar
Width: 400
Height: 120

Shift position of album image

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html?features=right
Width: 400
Height: 120

Disable background image (set background as transparent) and enable circle progressbar

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html?features=transparent-background+circle-progressbar
Width: 400
Height: 120

Disable background, text only version

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html?features=transparent-background
Width: 400
Height: 100 (everything under 101px is text only version)

Fullscreen width footer

URL of the widget: https://topik.github.io/youtube-music-obs-widget/index.html
Width: 1920
Height: 150

You can basically set any width and height. You can also open the page (https://topik.github.io/youtube-music-obs-widget/index.html) in your browser to test the size of the widget.

Text-only version

Widget will show only interpret name and song name. URL:https://topik.github.io/youtube-music-obs-widget/textonly.html

No-CSS version

Basic widget without no additional CSS. You can customize CSS via OBS or by downloading this project. URL:https://topik.github.io/youtube-music-obs-widget/nocss.html

Custom YTMDesktop Remote Access URL

If you want to fetch data from other source than 127.0.0.1:9863, you can use parameter url, for example: URL:https://topik.github.io/youtube-music-obs-widget/?url=https://example.tld:9863 (don't forget about the port)

Contributing

If you find some bug or if you write new feature, just fork this repo and make a pull request.

Contact

https://topik.dev