19 Streamers
jnktn.tv edited this page 7 days ago

Streamer's Guide

This guide will help streamers setup OBS up for connecting to the Jnktn.tv environment.

Recommendations

  • You should have a STABLE internet connection when you stream. If possible, connect to your network with an Ethernet cable.
  • Make sure to test your stream as much as you can. We recommend streaming for at least 1 hour when testing, to better ensure minimal issues when you go live on boradcast day.

Quick Guide

For those that have experience with OBS and know exactly how to configure the following settings

  • MAXIMUM Video Bitrate: 4000 Kbps
  • Audio Bitrate: 320 Kbps
  • Audio Sample Rate: 48 kHz
  • Stream Server: rtmp://live.jnktn.tv
  • Stream Key: The key you received via email

Now head to the Stream section.

Full Guide

Install OBS

OBS can be downloaded from https://obsproject.com/ for Windows and MacOS users. Instructions for installing on Linux can be found on the Linux link.

Initial OBS Setup

Once downloaded and installed, open OBS. If this is the first time you've run OBS, you will see the Auto-Configuration Wizard appear on your screen. Click Cancel to close it for now.

First things first, let's create a dedicated Profile and Scene Collection. At the top of the OBS window, click Profile then New and enter 'Jnktn'. Next, click Scene Collection then New and again enter 'Jnktn'. This is done to differentiate between different sets of configurations and scene collections, if ever needed.

Auto-Configuration Wizard

The easiest way to get the correct settings for your device when streaming with Jnktn.tv is to use the Auto-Configuration Wizard. To do this, click Tools then Auto-Configuration Wizard.

On the initial Usage Information page, leave Optimise for streaming, recording is secondary selected and click Next

On the Video Settings page, leave the Base (Canvas) Resolution as it is, even if the resolution shows a different set of numbers than the ones in this screenshot. Change FPS to 30, then click Next.

On the Stream Information page, change the Service to Custom.... For the Server, enter 'rtmp://live.jnktn.tv', and for the Stream key enter the key you were provided with. It should be your name or alias. Keep the box ticked for Estimate birtate with bandwidth test. If you see an additional box for Prefer hardware encoding, keep this ticked also.

You will then see this Stream warning. Click Yes to continue, and OBS will then go about finding the most appropriate settings for your system and connection. It may take a minute or two to complete.

You will end up with the Final Results screen. Click Apply Settings, which will close the window.

OBS Settings

Now we need to ensure some settings in OBS are configured correctly. In the main window, towards the bottom-right in the Controls dock, click Settings.

It's a good idea to automatically record your stream locally, so that we have a backup if somebody goes wrong on the server side. On the General tab, tick the boxes for Automatically record when streaming.

On the Output tab, let's configure the details in the area labelled Streaming. The Video Bitrate should be set to whatever the Auto-Configuration Wizard determined was best. This should be set to a MAXIMUM of 4000 Kbps. If it is currently set at anything higher, set it to 4000. If it is set to anything lower, set it to be 500 less than what it is currently set at. So if it currently shows 3000 kbps, lower it to 2500 kbps.

Leave the Encoder set at whatever it's set to. It might not match the same as in the screenshot, but that's fine. For the Audio Bitrate, change it to 320. Leave the settings in the Recording area as they are.

On the Audio tab, set the Sample Rate to 48kHz.

Those are the basic settings configured for streaming to Jnktn.tv. Click Apply to apply them then OK to close the window.

Stream

Please note that ALL streams sent to the server are recorded by default, including any tests that done as part of setting up. This is done so that we can examine the quality of incoming streams to ensure there are no issues.

Stream Health

With your settings now configured, you're all set to start streaming. Click Start Streaming in the Controls dock to do so. If all is well, OBS will start streaming. At the bottom of the OBS window you should now see various pieces of information, some of which indicate the health of your stream.

The most important factors showing here are Dropped Frames and the Bitrate of the stream, each at opposite ends of the information shown. The Bitrate in kb/s on the right shows the birate at that exact time. It's perfectly normal for it to move around a bit, depending on the scene currently being displayed. The coloured square to the left of the Bitrate should ALWAYS be green. If the square changes colour to yellow, orange or red, then this shows that you're having difficulty maintaining the configured Bitrate. See the Troubleshooting guide below if your experience this.

Testing

Testing is an absolutely essential part of streaming with Jnktn.tv. This helps identify issues with your OBS setup and internet connection, as well as the connection to the streaming server. As in our Recommendations above, it is advised to stream for at least 1 hour. We've found that although a stream can look completely healthy for 5, 10, or even 30 minutes straight, there are still potential issues that can arise after this time.

Testing should ideally be done as far in advance of the day you go live as possible. If you identify any issues when testing, please reach out to a member of the team as soon as possible and they will be in contact to either provide advice on how to resolve your issues, or to organise a call where the issues can be looked into with your help. We will do our absolute best to ensure your stream goes as smoothly as possible.

Testing your stream does not interfere at all with the main stream at Jnktn.tv, so feel free to test during our broadcast if needed.

Stream Playback

So you're testing the stream and all looks well, but how can you really be sure that it's 1) being received OK and 2) looking as good as you think it does? Worry not, since you can watch back the stream directly from the streaming server itself.

Jnktn.tv recommends using an application called VLC to watch back outgoing streams, although any application that supports RTMP streams can be used

Download VLC: https://www.videolan.org/vlc/download-windows.html

To play one of the links below:

  1. Open VLC media player
  2. Click Media > Open Network Stream...
  3. Enter the URL below
  4. Click Play
rtmp://live.jnktn.tv/<STREAM_KEY>

Please note that there will be a delay between your output and the stream you watch back. It might be best to load the stream on a second device, so as not to conflict with your outgoing stream. VLC is available for mobile devices also, although make sure to be connected to WiFi when watching back a stream since you can quickly run out of data if not, depending on the amount of data on your plan.

Access Recordings

All streams sent to the server are recorded by default. To access your recordings, head over to https://videos.jnktn.tv. There you will find all recorded streams, from all streamers. Your streams will start with your stream key, followed by the date and then the time. Clicking on a stream should play it in the browser, so there's no need to download it.

Additional Information

Troubleshooting

TO BE COMPLETED