Outputting track data to OBS * New for VMX 2.2.4+ *
- September 2, 2019
- 8. Advanced Configuration options
VMX 2.2.4 and higher only
VMX’s Track Data Output hands over your VMX music playing activity such as track name and artist for use in OBS Broadcast streaming software. VMX also outputs context mode status information including cooldown mode details. The VMX -> OBS output data feature is always enabled by default so you need do nothing to activate it. VMX Track Data output is sent to 2 text files (.txt), both of which are automatically refreshed reflecting current track and mode information.
Important: You must have loaded VMX 2.2.4 Dark Edition at least once for the track data text files to be created. Feel free to leave VoiceAttack and VMX loaded whilst you add the text files to OBS.
In order to capture VMX Track Data you need to locate the 2 text files output by VMX, note that you may use one or both of the text files depending on whether you want only the track title and artist or context mode status or all of the above.
VMX outputs the two text (.txt) files to Windows partition in the following location: ‘Users/<username>/Appdata/Roaming/VMX_StreamData’. Replace <username> with the username you use on your PC i.e ‘Users/JoeBloggs/Appdata/Roaming/VMX_StreamData’. Within this folder you will find 2 files. Trackdata.txt and Contextdata.txt. These are the ones to import as Text(GDI+) into OBS Broadcaster. If you are experienced with OBS and showing text data on your stream then the above is likely all the information you need to get up and running.
For users who haven’t loaded text from files in OBS before or who may be new to OBS I have provided a detailed step by step procedure below with screenshots as well as a video tutorial, above.
- Step 1: Start up VMX Dark Edition 2.2.4 (or higher) in VoiceAttack in the usual way so that VMX may create the text files for us to import later. Once VMX has loaded, you may close VoiceAttack if you wish. Now, load OBS Broadcast software.
- Step 2: Within OBS, click the ‘+’ to add a new source and select “Text(GDI+)” as the source type to add. See image below.
- Step 3: After selecting ‘Text(GDI+) you will be asked to name the new text source, call it ‘VMX Context data’. You can name this source whatever you wish, but to avoid the naming scheme becoming confusing it’s recommended to use the above source title. Click ‘OK’.
- Step 4: After clicking ‘OK’ you will now be presented with a new window entitled ‘properties for VMX Context data’. You will notice at the top a Font selection option and below that a tickbox area which says “Read from file”. You need to click the ‘Read from file’ tickbox which will show you some new options with which you can import VMX’s track data text files.
- Step 5: After ticking ‘Read from file’ you will see that a new ‘Browse’ button appears, as shown in the image below. Click the ‘Browse’ button.
- Step 6: Navigate to your Windows Appdata/Roaming/ folder, usually located at ‘C:/Users/<username>/Appdata/Roaming/. Replace <username> with the username you use on your PC i.e ‘C:/Users/JoeBloggs/Appdata/Roaming/. Your Windows installation may be on a drive partition not named C:/ it may be D:/ or something else, navigate to the correct drive letter where you have Windows installed. The image example below contains Windows installed to C:/ and username of ‘Kate Jones’. Once you have located your Roaming folder, look within it for a folder called ‘VMX_StreamData’, the image below shows the entire path to VMX_StreamData and the 2 VMX .txt files contained within it.
You should see VMXStatusinfo.txt and VMXTrackinfo.txt files within VMX_StreamData folder.
Select ‘VMXStatusinfo.txt’ and click ‘Open’. This will now add VMXStatus information to your new Scene in OBS. You may resize the text box to the size you wish, ensure that all the text fits on your OBS screen nicely.
To add VMX Track information you need to repeat Step 2-6 exactly as before, only this time in Step 6 you will need to add ‘VMXTrackinfo.txt’ rather than VMXStatusinfo.txt so as to add VMX Track information (track title and artist) to your stream.
If you are unsure about anything, please follow the video tutorial at the top of this knowledgebase page which will guide you through everything step by step showing you the process in action.