Skip to main content

Live Stream with XML Configuration

Configure your streaming device for custom live broadcasts with XML

Updated today

Live streaming with XML-based devices like ATEM Mini Pro allows you to broadcast professional-quality streams directly to your Uscreen audience. This guide will walk you through setting up your XML configuration to connect your hardware switcher with Uscreen's streaming platform.

📝 NOTE: This guide is intended for users with XML-based streaming hardware such as ATEM Mini Pro. If you're using different streaming software, please refer to our Setting Up a Live Stream with 3rd Party Tools article.

Prerequisites

  • A switcher with an integrated control panel (e.g., ATEM Mini Pro)

  • Access to the streaming.xml file location on your computer


Obtain the streaming.xml File

  1. Find your streaming.xml file:

    • Windows

      • Navigate to C:\Program Files (x86)\Blackmagic Design\Blackmagic ATEM Switchers\ATEM Software Control

    • macOS

      • Open Finder, then go to /Library/Application Support/Blackmagic Design/Switchers

  2. If you can't find the file, you'll need to create one


Configure the XML File

  1. Open the streaming.xml file using a code or text editor

  2. Copy everything from the start to the end <service> tag and paste it below the last tag

  3. Change the Service Name to 'Uscreen Live' or another name of your choosing

  4. Keep the server name as 'Default'

  5. Update the RTMP URL within the <URL> tags with your Uscreen Live Stream URL

  6. Adjust streaming settings to match Uscreen's recommended settings:

    • Video Codec: H.264 (Main Profile)

    • Audio Codec: AAC

    • FPS: 30 or 60 FPS (Uscreen is optimized for these frame rates)

    • Bitrate: 5000 kbps (1080p), 3500 kbps (720p), or 1000 kbps (480p)

  7. Save the file to its original location

    • If you encounter permission errors, try saving them as a sudo

<?xml version="1.0" encoding="UTF-8" ?>
<streaming>
<service>
<name>Uscreen Live</name>
<servers>
<server>
<name>Default</name>
<url>rtmp://global-live.uscreen.app:5222/app</url>
</server>
</servers>
<profiles>
<profile>
<name>High Quality</name>
<config resolution="1080p" fps="30">
<bitrate>7500000</bitrate>
<keyframe-interval>2</keyframe-interval>
</config>
</profile>
<profile>
<name>Great Quality</name>
<config resolution="720p" fps="30">
<bitrate>3500000</bitrate>
<keyframe-interval>2</keyframe-interval>
</config>
</profile>
<profile>
<name>Good Quality</name>
<config resolution="480p" fps="30">
<bitrate>1000000</bitrate>
<keyframe-interval>2</keyframe-interval>
</config>
</profile>
</profiles>
</service>
</streaming>

ℹ️ INFO: We've included an XML file sample that you can download and use with your ATEM or XML-based streaming device.


Set up your Live Stream in ATEM Software

  1. Restart your ATEM Software Control

  2. Navigate to Output > Live Stream

  3. Select 'Uscreen Live' (the Service Name) from the dropdown

  4. Copy and paste your Uscreen Live Stream Key into the Key area

  5. Select your desired quality

  6. Click On Air to start streaming

Additional Details

  • The streaming.xml file must be in the correct destination with a valid name

  • To verify your settings, go to File > Save As in the ATEM Software Control

  • If you open this saved file, you can see all settings for your ATEM at the bottom

📝 NOTE: If you need additional assistance with your streaming device, it's best to consult with the device manufacturer.

Did this answer your question?