Configuring the RTMP Streamer actor to connect with Twitch requires a few simple steps, and the setting of two inputs in the Isadora RTMP Streamer actor. You will need to set both the 'server url' input and the 'stream key' input of the actor, both using information provided by Twitch.

This article assumes you have a Twitch account, and can login to Twitch.

Prepare Isadora for Your Twitch Stream Settings

  1. Open Isadora (3.1 or later)
  2. Assuming your have already downloaded and installed the RTMP Streamer add-on. Double Click in the Isadora scene editor and type RTMP into quick search dialog. Select RTMP Streamer when listed to add it to the Isadora scene.
  3. You will use the server url and stream key inputs to hold values provided by Twitch in the next steps.

Locate Your Nearest Stream Ingestion URL

Unlike many other streaming services, Twitch gives you a number of options when it comes to your Stream URL (which they refer to as Stream Ingest Endpoints). Twitch provides a webpage listing a number of endpoints they say provide optimal network paths, and it is from there that you will choose your the Stream URL needed by RTMP Streamer.

  1. Open Twitch's recommended ingest endpoints page. It is from this page that you will select a Stream URL. 
  2. Generally you will want to use item #1 as your ingest server because Twitch has automatically determined that this is the most efficient server connection available.
  3. For use with Isadora, you do not want to use the /{stream_key} part of the URL. So, carefully select the text starting at rtmp:// and ending just before the slash before /{stream_key}. (See the image above for an example of what to select.)
  4. Choose Edit > Copy to copy the URL to the clipboard.
  5. Then, in Isadora, click  the 'stream url' value input of the RTMP Streamer actor and choose Edit > Paste. Double check to ensure that you have pasted the entire URL from the recommended ingest page, except for the /{stream_key} portion.

Open Twitch.tv and Setup Your Stream

  1. Open an internet browser on your Mac or PC and head to Twitch.tv and log in if you aren't already.
  2. Click your circular profile icon in the top-right corner and select "Creator Dashboard" from the drop-down menu.
  3. Once your Creator Dashboard loads you will have a new menu on the left side. Click the gear icon in this new left side menu (labelled either 'setting' or 'preferences'). If you don't see it, click the three horizontal lines in the top-left corner of the screen to reveal it.
  4. When you click the gear icon more options will appear under it. Click "Stream".
  5. You'll see a page titled "Stream Key & Preferences."Your stream key will be at the top. You can copy your stream key without seeing it by clicking "Copy," or click "Show" to reveal and copy it manually.
    ⚠️⚠️ 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!
  6. Paste this Stream Key into the stream key input of the Isadora RTMP Streamer actor

You should now have all the information required from Twitch to allow the RTMP Streamer actor to connect to Twitch. 

Clicking Stream Manager (upper left section, above the gear icon you clicked earlier) in Twitch will take you to a Stream Preview page. Viewing this page will allow you to see your video stream once Isadora is connected.