Supported Bit Versions
  1. 32-bit
  2. 64-bit
Source Code URL
Minimum OBS Studio Version
Supported Platforms
  1. Windows
  2. 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.
  • 2019-08-11_23-32.png
    926.8 KB · Views: 18,351
  • Screenshot_20200219_022639.jpg
    252.5 KB · Views: 32,980
  • Screenshot_20201013_230446.jpg
    249.8 KB · Views: 120,154
First release
Last update
4.60 star(s) 30 ratings

More resources from universallp

Latest updates

  1. Format refactor

    Completely overhauled the formatting system. Now uses full variable names like {title} or...
  2. Added cover download option

    If enabled tuna will download missing covers from
  3. Fixed Spotify token issues

    Fixed token termination not being saved correctly Fixed token refresh using wrong data type for...

Latest reviews

Upon following your two video tutorials, plus reading the top resulted comment that fixes this, the song title still refuses to appear as anything more than "%t" when using a VLC Media Source.. Cover art appears perfectly fine, anything else is a no-go.
The latest version uses different formatting, the title would be {title} instead of %t
Exactly what I needed!
I love it, really clever and easy to use!
Thank tou very much! Been using this plugin for a while, so useful please keep it up!
Great plugin! But I have a problem using VLC.
The title and artist are displayed, but the cover art is not.
I also have VLC in the source.
Please help!

Windows 10 pro
OBS ver. 27.2.3 64bit
VLC ver. 3.0.16
Do the files have covers embedded? You can check with if the file doesn't have a cover it won't work.
great plugin, everything is implemented very cool and convenient
Just thanks
I'm having problems with using Spotify.
At first, I tried ignoring the client id and secret part because it wasn't on the instructions, but after successfully receiving the token and pressing the apply button, the acc was automatically logged out. When I then tried filling the client id and secret, the login page kept saying it was a invalid URL
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