Supported Bit Versions
32-bit, 64-bit
Source Code URL
Minimum OBS Studio Version
Supported Platforms
Windows, Linux

Lets you display information about the currently playing song in obs without running a third-party app.
Currently supports these music sources:
  • Spotify (All song information (except for song label), including Cover art)
  • MPD (All song information*, including Cover art)
  • VLC Video source (All song information*, including Cover art)
  • (Cover art, some song information)
  • Google Play Music™ Desktop Player (Cover art, some song information)
  • Window title/process name (additional formatting, like cutting characters)
  • Soundcloud, Yandex Music and Spotify Web Player via the tampermonkey script
*as long as the files are tagged correctly, check with or
Where is the song information?
The information is provided via text and image files, which can be configured in the tuna dialog, under Tools > Tuna settings. To display the information you have to add a text and image source and point them to the text and image file respectively:
You can also display information through the browser source, scroll further down to "Browser widget" for more information.

How do I change the placeholder cover?
The placeholder image is saved under C:\Program Files\obs-studio\data\obs-plugins\tuna\placeholder.png or ~/.config/obs-studio/plugins/tuna/data/placeholder.png. It can be replaced with a transparent png if you don't want anything to show when nothing is playing.

Either run the installer or follow these steps:
  1. Open your obs-studio installation folder (eg. Right click on the shortcut and click "Open file location")
  2. Navigate two directories up
  3. Drop the contents of the folder plugin in the directory
  4. Merge the files
  5. Tuna should now show up in the tools menu of obs-studio
If you use a debian based distro you can use the installer, otherwise follow these instructions:
  1. Unzip the archive
    $ unzip ~/Downloads/tuna.* -d ~/Downloads/tuna
  2. Navigate to your obs config
    $ cd ~/.config/obs-studio/
  3. Create a folder for the plugin
    $ mkdir plugins
  4. Copy the folders contents of the folder plugin into the new folder
    $ mv ~/Downloads/tuna ./
  5. Tuna should now show up in the tools menu of obs-studio
Run the installer and keep in mind that I do not offer support for the macOS version.
This tab sets up settings like where to save the cover and song info files. It also contains information about formatting, which is fairly self explanatory. It also let's you switch where the plugin gets the song information from and whether the plugin is running.

The refresh rate is used to set how often the plugin should query the song information, you shouldn't set this too low for Spotify, since every refresh means a request to the Spotify servers.
If the information refreshes slowly, you'll have to use your own API Credentials:
To use the Spotify source follow these steps:
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "Spotify" as the music source
  4. Select the "Spotify" tab
  5. Click "Open login page" and accept the info message (might also wanna read it)
  6. Verify the URL, login and grant access
  7. Copy the code into the "Authentication code" field
  8. Click "Request token"
  9. You're done! If there were errors they will be logged in the textbox under "Response log"
If you experience issues at some point, you can click "Perform refresh" to request a new token, or completely login again by clicking "Open login page" again.
If you continuously experience login issues, make sure that
  1. You have the latest version
  2. The Spotify servers aren't down or the API isn't rate limited (you can check by looking at the obs studio log)
  3. You cleared your cookies for the login page (using incognito mode also works)
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "MPD" as the music source
  4. Select the "MPD" tab
  5. Enter the MPD server IP and port (or select local connection)
  6. You're done
(the video is a bit outdated, since you can now use multiple vlc sources across different scenes)
Only works with VLC >=3.0.0
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "VLC" as the music source
  4. Select the "VLC" tab
  5. (Click refresh if your source doesn't show up)
  6. Select the scene from the drop-down menu
  7. Select the VLC source from the drop-down menu
  8. Click add
  9. You're done
This currently doesn't work if your VLC source is in a group or otherwise nested. The hotkeys for switching can be configured in the hotkeys tab in the settings dialog of obs.
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "Google Play Music Desktop Player" as the music source
  4. That's it
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "Window title" as the music source
  4. Select the "Window title" tab
  5. Enter any search term (e.g. Firefox, to search for any window that contains the word Firefox)
  6. Optionally add a search and replace term and/or cut the first or last characters
  7. You're done
  1. Click on "Tools" at the top of the obs window
  2. Select "Tuna settings"
  3. Select "" as the music source
  4. Select the "" tab
  5. Enter your user name and if you have it your own api key
Open or close the dock by selecting View > Docks > Music control. You can also close the dock via the 'x' button when it's undocked or the UI is unlocked. Rightclick anywhere in the dock window to set what information you want displayed.
First release
Last update
4.77 star(s) 22 ratings

More resources from universallp

Latest updates

  1. Fixed Spotify token issues

    Fixed token termination not being saved correctly Fixed token refresh using wrong data type for...
  2. VLC Source mapping, IceCast, Fixes

    Added option to choose VLC sources per scene and scene collection Added IceCast support Added...
  3. Fixed crash

    Fixed crash when retrieving spotify token Spotify token is now asynchronous so it won't freeze...

Latest reviews

Excelent plugin! Love it!
Found it better than other plugins out there. Very easy to use but was a little bit difficult to install. But the developer is very patient and helpful. So don't worry!
Excelent puglin
very great and simple to use, i am using the Browser Widget version which is working just fine. but i wish there was a version without the progress bar just the album art with song and artist below song name. i tried making it in HTML but i am not that good at it
Works like a charm :)
Nightly #75 (with commit ec8cd3f) had the fix for the auto-refresh token <3 Thank you

Would it be possible to add a "previous track info" features?
Maybe as a checkbox when editing an output that then allow to save the info to a "<song info path>_previous" file before writing the new track info
I have it downloaded, but it won't let me add any text files or any thing to the info tab; when i hit ok it exits and nothing happens ;;
I'll be the hipster but any chance you can get this to speak with Winamp?

Yeah, I'm that monster.

But I am getting constant crashes with OBS 25.0.8 in inputting anything with, having the program read a program (trying for Winamp, hence the asking for it above), and VLC player.
the latest release has some issues, but the previous one should work fine
I'm having some issues with using VLC I did read this in the comments "Do you have any VLC sources added? It only works with VLC sources not with the actual VLC player" but I have no idea how or where I would put these sources, and whether or not a simply VLC playlist file suffices? great little addon though
You have to add a VLC Video source, which can load playlists or individual files.
Love this plugin, I really do. But I really hate that media control dock that was added recently. Mostly because I can't seem to find a way to not make it show again on startup every time.
I always have to go and manually turn it off from the docks menu every single time I start OBS.
I have no use for this dock at all, so it is really, really annoying.
can't manage to make it work with chrome with OBS 25.0.8 :/ i don't know why, i followed all the steps one by one
What do you mean by "make it work with chrome" what music source are you using?