Supported Bit Versions
32-bit, 64-bit
Source Code URL
https://github.com/univrsal/tuna
Minimum OBS Studio Version
23.0.0
Supported Platforms
Windows, Linux
2019-08-11_23-32.png

Tuna
Let's 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, including Cover art)
  • MPD (All song information, including Cover art)
  • VLC Video source (All song information, including Cover art)
  • last.fm (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 and Spotify Web Player via the tampermonkey script
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 mroe information.
Windows
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
Linux
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
macOS
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.
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 univrsal.github.io (using incognito mode also works)
Using your own Spotify API credentials:
  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
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. Select the VLC source from the drop-down menu
  6. You're done
  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 "last.fm" as the music source
  4. Select the "last.fm" tab
  5. Enter your last.fm 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.
Author
universallp
Downloads
25,848
Views
67,669
First release
Last update
Rating
4.72 star(s) 18 ratings

More resources from universallp

Latest updates

  1. Webbrowser source

    Fixed Google Play Music Client on Windows not finding the song information Added Web browser...
  2. Browser Widget

    Added the option to host song information locally as a JSON file, which can be accessed by the...
  3. Small fixes and update to OBS 26.0.0

    There were some issues with 1.5.0, which I hope I addressed all with this release, but if you...

Latest reviews

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 last.fm, having the program read a program (trying for Winamp, hence the asking for it above), and VLC player.
universallp
universallp
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
universallp
universallp
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
universallp
universallp
What do you mean by "make it work with chrome" what music source are you using?
Looks like a good plugin. Trying to get it working with VLC but the source only has "none" on it and refreshing doesn't add anything. Any ideas?
universallp
universallp
Do you have any VLC sources added? It only works with VLC sources not with the actual VLC player
Great Plugin. Litle complicated, but after some time I got what I wanted.

But... how do I uninstall the plugin. I did it with the Control Panel and by deleting the files, but the Music Control panel still shows up at the beginnen.
universallp
universallp
running the uninstaller should take care of it if you're on windows, otherwise you have to delete the plugin files manually
I found it a little hard to setup, but I'm pretty sure that's just me as I have inexperience with using OBS plugins. I am using it for a 24/7 music stream, and it is a great plugin to use. I would recommend this if you are trying to use this for a 24/7 stream, or for any stream that you are trying to show song info.
Thanks for the update and fix on the placeholder image :D
and oh! I don't know if that was there before, but just saw the "hide when paused" option for the progress bar. Thanks!

If you'd like a report on the dock, the buttons don't seem to interact with Spotify at all. forward, back, or play/pause. The song name does update and the image for "play/pause" does change if I play/pause it with my keyboard or the program itself. (Just reporting for others who might want use it)
universallp
universallp
Yeah I noticed the issue with spotify, I think I know what's causing it'll just take a bit for me to fix it.
Top