Tuna OBS Forums

How do I set this up?

To ensure that you get the most out of this plugin and get it set up correctly it's encouraged that you read through the following instructions thoroughly.

Spoiler: Installation and the basic UI

A basic part of this plugin is the ability of OBS to load both image and text files from disk. If you do not know how that works it is strongly recommended that you familiarize yourself with both the image and text source first:

OBS Studio - Free and open source software for live streaming and screen recording - obsproject/obs-studio

Table of Contents * [Scenes and Sources Overview](#scenes-and-sources-overview) * [Source Descriptions](#source-descriptions) * [Audio Input Capture](#audio-inputoutput-capture) * …

Table of Contents * [Scenes and Sources Overview](#scenes-and-sources-overview) * [Source Descriptions](#source-descriptions) * [Audio Input Capture](#audio-inputoutput-capture) * …

The first step is to install the plugin for which you'll have to follow the installation steps for your platform:

Spoiler: Installation

Windows

Either run the installer or follow these steps:

1. 
   
2. Open your obs-studio installation folder (eg. Right click on the shortcut and click "Open file location")
3. 
   
4. Navigate two directories up
5. 
   
6. Drop the contents of the zip file (a "data" and "obs-plugins" folder) into the obs-studio directory
7. 
   
8. Merge the files
9. 
   
10. Tuna should now show up in the tools menu of obs-studio
11. 
    

Linux

If you use a Debian based distro you can use the installer, all other distros currently have to either build the plugin from source or manually extract the binaries from the debian installer and move them into the correct folders, the latter approach might not work on all distros. If you use the flatpak version of obs I can't help you as I have no experience with it. There have been reports that the plugin does not load with the flatpak version.

After you've installed the plugin you should see a new option in the Tools menu:

If it does not show up it means that either the plugin wasn't installed correctly or that OBS couldn't load it. In that case an obs studio log is necessary to help fix the issue.

After you click on the menu this dialog will open:

1. 
   
2. This is the path to which Tuna saves the cover of the currently playing song. You can leave the default or change it via the "..."-button to a different path if you want. Just remember it later when you add an image source for the cover.
3. 
   
4. If you uncheck this checkbox Tuna will not download the cover of the currently playing song
5. 
   
6. If you check this option Tuna will attempt to look for covers by querying Apple's iTunes servers. This will use the album and artist of the currently playing song to search for matching album art. This means that the art that is found might not be exact. You can also choose the resolution that should be downloaded.
7. 
   
8. If this option is enabled Tuna will remove file extensions from song titles (e.g. .mp3, .wav, .flac etc.). This is useful if you play music through the VLC Source and the songs do not have any metadata saved. In that case VLC will use the entire filename as the title, including the file extension.
9. 
   
10. With these buttons you can add, remove and edit format outputs. They'll be described shortly.
11. 
    
12. Enable this option if you want to use the user script which allows Tuna to receive song information from your web browser or if you want to use the browser widget.
13. 
    
14. All output text files will contain this text if nothing is playing
15. 
    
16. Here you can switch between the different supported music sources. Tuna will use the selected one to look for the currently playing song.
17. 
    
18. This is the rate at which Tuna will refresh song information
19. 
    
20. With these buttons you can start and stop Tuna. If the plugin is stopped it will not look for song information and it will not update the outputs.
21. 
    

Spoiler

Since the information is displayed through text sources, which read text from files on your computer you have to configure Tuna to tell it to create these text files and what should be in them. In the main dialog under the "Basics" Tab you can add, edit and remove outputs:

Adding or editing outputs will show this dialog:

The first option defines where the information is going to be saved. Click the "..."-button to select a file path. After that you have to define what information the text file is going to contain. The dialog gives you all options that are supported by Tuna, but keep in mind that not every music source provides all information.

OBS Studio - Free and open source software for live streaming and screen recording - obsproject/obs-studio

Table of Contents * [Scenes and Sources Overview](#scenes-and-sources-overview) * [Source Descriptions](#source-descriptions) * [Audio Input Capture](#audio-inputoutput-capture) * …

Table of Contents * [Scenes and Sources Overview](#scenes-and-sources-overview) * [Source Descriptions](#source-descriptions) * [Audio Input Capture](#audio-inputoutput-capture) * …

If you want to display the artist and the song title you would enter "artists - title" into the textbox at the bottom without the quotes. artists and title will be replaced by the artists and the title of the currently playing song. So the text file would for example contain "Rick Astley - Never Gonna Give You Up". If a song features multiple artists it will list all of them separated by commas (provided that the music source provides all artists). If you only want the first artist to show up you would use first_artist. If you use a formatting option that isn't supported by the currently selected music source the plugin will notify you.

The plugin also has the option to capitalize all letters. If you use TITLE instead of title the file would contain "Rick Astley - NEVER GONNA GIVE YOU UP". You can also limit formatting options to a certain amount of characters. TITLE:10 would make sure that the song title will be cut off after ten characters so the file would contain "Rick Astley - NEVER GONN...".

If the "Chat log mode" option is enabled Tuna will append the currently playing song at the end of the file so if you are currently paying "Never Gonna Give You Up" and then switched to "Whenever You Need Somebody" the file would contain:

Rick Astley - Never Gonna Give You Up

Rick Astley - Whenever You Need Somebody

Rick Astley - Never Gonna Give You Up

Rick Astley - Whenever You Need Somebody

Basically just enter the server url and make sure that the server provides information via a status-json.xsl.

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.

Spoiler: Web browser source

926.8 KB

· Views: 48,073

252.5 KB

· Views: 53,632

249.8 KB

· Views: 156,308

74.8 KB

· Views: 26,626