Content

This article describes how to configure an RTMP upstream in Streamboxy and which encoder settings are required.


Prerequisites
  1. You have a Live Encoder that outputs RTMPs, is TLS 1.2 capable and supports Constant Bitrate Streaming - CBR (e.g. Telestream Wirecast from 13.0.2, OBS Studio, VMIX, Cambria Live from 4.3, FFmpeg, Haivision KB)
  2. Your internet upstream speed is at least 12 Mbits für a fluid 1080p stream with 30 Frames per second
  3. Your firewall allows outgoing TCP-Connections over port 2935 and 2936 (RTMPS), optional as Fallback TCP-Port 1935 and 1936 (RTMP)
  4. You have created a Livestream in Streamboxy and have the authorization to manage the upstream (You are at least speaker)

Proven upstream settings

Below we have compiled a list of proven settings for a good upstream result for you

Parameter Settings
Stream URL/Server URL Copy the Upstream URL from Streamboxy (see below)
Stream Key (Sometimes required by OBS or other encoders) Default
Output resolution 1920 x 1080 alternatively 1280x720
Streaming Bitrate (Constant Bitrate - CBR) 6.000 Kbps (Your internet connection should provide at least the double upstream speed)
Keyframe Interval 2 sec
Framerate max 30 Fps
Video Codec H.264
Audio Bitrate min 160 Kbps
Audio Sample Rate 44.1 kHz, 48 kHz
Audio Codec AAC-LC, HE-AACv1 or HE-AACv2


Streaming Best Practices


Stream Connection

  • Use a wired connection if possible and make sure your connection has at least the double amount of upstream bandwidth of your planned streaming bitrate
  • Check, especially in corporate networks if your Streaming Ports are not blocked by a firewall 


Stream Stability 


  • If you are using a software encoder, please close all other unnecessary programs
  • Changing the encoder configuration once the stream was started can impact the Stream in a negative way. Reset the stream using the Streamboxy reset feature (described below) if you have changed encoder settings
  • Test and validate new Encoder Hard- or Software versions before you use them in production. The Encoders described here, are not regularly checked for updates, etc.
  • Monitor your Streaming Hardware resources (CPU, RAM, etc.), since encoding may exhaust your hardware resources

Stream execution and organization


  • Conduct a dry run a few days prior to your event, this included in the Streamboxy license and ensures that you are ready and rehearsed when its showtime
  • Reserve some time to get everything ready for setting up the stream. We recommend starting the streaming in preview mode 30-60 min before showtime
  • Start your stream at least 15 minutes before the program start for Attendees and play Trailer etc. as a placeholder which should contain audio or background music
    This allows Attendees to check Video and Audio and maybe get some support before the main program starts
  • Check the Attendee experience with a dedicated device, so that you can check what everyone is currently seeing
  • Distribute Video- & Sound- Operation and content moderation to different people so that everyone can focus on their job


Setting up, starting, and ending of Streams in Streamboxy

1. Gather the Upstream Key in Streamboxy


A Livestream can be played either in the main room or in individual breakout rooms. In case you want to start a Livestream in a Breakout Room, you need to navigate there first.


Open the Room for speaker

To Request a Livestream URL the Room must be opened for Speaker, this allows all Speaker or Admins to set Streaming settings and view the stream preview.


  1. Open the Streamboxy Stage as Speaker or Administrator and Navigate to the desired Breakout room with the Livestream

  2. Open the Session Administration Panel using the Tools Icon in the left navigation bar.


  3. Click on the Button "Open Room"


Requesting the Upstream URL


  1. Once the Room is open you can request the Upstream-URL using the "Request Upstream URL" Button.
    Depending on the current system load this may take a few minutes to be provisioned.




  2. Once the Streaming environment is provisioned an Upstream URL appears, which you can add to your clipboard using the copy symbol right next to the URL textbox. You need this URL to configure your streaming encoder



2. Configure and Start your encoder using the upstream URL


You must now configure your encoder and start the stream in order to proceed in Streamboxy.


You can try everything in this tutorial using the Free Software Encoder OBS Studio.
How to use OBS with Streamboxy is described in this article.


Articles describing other encoders can be found here.


3. Check the Preview in Streamboxy


Once your encoder is configured and started, you should see the Stream preview. 

The Preview is only visible to you and other speakers or admins, participants still see the waiting poster.


All Features of the Preview Player are identical to the features of the participant player, which is described here.



4. Start Livestream for participants and Recording


To be able to start the Livestream for attendees you need to have an Encoder connected first. To make the stream visible to the participants click on the button "Start Livestream for Attendees".




From now on the attendees will also see the Livestream. In addition, the recording is started from this point on.


5. Ending the Livestream


We recommend ending the Streamboxy session prior to ending the stream in the Encoder. This ensures a better attendee experience and a controlled end of the recorded stream.

To end the Livestream in Streamboxy, click on the button "End Livestream for Attendees".

This ends the Stream for attendees and stops the recording.



8. After the Livestream

After the end of the Livestream, you and your participants will immediately see the recording if the Session is configured to show recordings. 

If you have selected the Analyze Video option, the transcript will appear shortly (this usually takes as long as the stream itself lasted).

You can also decide now if you want to hide/show the recording or you want to delete the recording. 


You can also permanently deactivate the session or reset the session to the stat planned, in case you accidentally closed the session.




Further Information

Further Information regarding the user interface can be found here.

Detailed information about the session states and their implications can be found here.