The RTMP Streamer actor allows you to stream video and audio to services like YouTube, Twitch, Facebook, and more. This article is a quick start guide that is meant to get you streaming to these platforms in minutes.
This plugin is compatible with Isadora 3.1 or later; you cannot use it with an earlier version of Isadora.
⚠️⚠️ WARNING: KEEP YOUR STREAM KEY PRIVATE! ⚠️⚠️ You need keep your stream key private, otherwise others could stream to your channel without your permission! The stream key is hidden from view in Isadora, but can be read by others when someone clicks on the 'stream key' input value of the RTMP Streamer actor. If you need share a file that includes the RTMP Streamer actor, you must be sure to clear the 'stream key' input first!
Using the RTMP Streamer Actor
Step 1: Install the RTMP Streamer Actor
Since the RTMP Streamer actor is distributed as an external add-on through the Troikatronix Add-Ons page, it is necessary to download and install the actor for use with Isadora.
Step 2: Prepare RTMP Streamer
Before setting up the stream URL and stream key inputs of RTMP Streamer, you should set up the other parameters:
video in: This is the input where you will provide the video for streaming. For best performance, it is important that the resolution of the incoming video stream is one of the standard HD (High-Definition) or SD (Standard Definition) sizes like 1920x1080, 1280x720, 640x480, etc.
a/v mode: Leave it set to both. (Eventually, we'll allow you to stream just video or just audio, but for now, don't change this input.)
h264 profile: Leave this set to auto. (If you are an expert regarding h264 profile levels, you can switch between the base, main and high profiles. We recommend you let the encoder decide.)
video rate kbps: This controls the average kbps (thousands of bits per second) allowed for the video stream. For 1280x720 video at 30fps, use 2500; for 1920x1080 at 30 fps use 4000. This table from Google gives additional suggestions for other resolutions and frame rates.
audio source: For the moment, RTMP Streamer accepts audio only from a normal audio input device on your computer. To choose a source, simply click on this input – a popup menu with all the available audio devices will appear.
On Windows, you can choose the system audio output as the audio input source. On macOS, you need to do a workaround to create an "aggregate audio device". This article explains how to do this for OBS; you can follow the same procedure for RTMP Streamer.
audio rate kbps: This controls the average kbps (thousands of bits per second) allowed for the audio stream. Only certain rates are allowed. To choose a rate, right-click or control-click this input to choose the possible rates from a popup menu.
audio offset: This input allows you to offset the audio in relation to the video to improve sync. You should leave this set to zero unless you are experiencing sync issues.
logging: This input should remain set to none unless Troikatronix support instructs you to change this setting to aid in a technical support issue. The setting change only takes effect after restarting Isadora.
broadcast: Once you've set the 'server url' and 'stream key' inputs, you can turn this input 'on' to start streaming, and turn it 'off' to stop.
Step 3: Set the Server URL and Stream Key
To use RTMP Streamer, you need two things from your streaming service: the stream ingestion URL and the stream key.
These articles outline how to find these values for YouTube, Twitch, and Facebook.
- Configuring YouTube for the RTMP Streamer Actor
- Configuring Twitch for the RTMP Streamer Actor
- Configuring Facebook for the RTMP Streamer Actor
For further instructions on how to stream to these services, please consult the support pages offered by those services.
If you are connecting to another service these articles will still help you understand the requirements and it is suggested you read the Twitch article since Rtwitch requires additional steps not required by the other two.
Step 4: Connect Your Video Input and Set Broadcast to On
Now that the RTMP Streamer is configured a video source needs to be connected to the video in input. This video source can be anything in Isadora that provides vid-gpu formatted video out.
Finally switch the broadcast input from off to on. (see broadcast in the input list above)
You will see the broadcasting output change from off to on, and the status output change providing additional feedback regarding the current connection status.
NOTE: Please be patient! Some services can take several seconds before they display an image. (It shouldn't take more than 60 seconds though – if you don't see an image, try turning this input off and then on.)