Dashboard

Control many of the basic features of the server.

1. Navigation links to the Dashboard, Remote OBS, Settings, current stream destination, as well as shutdown and logout buttons
2. Start and Stop buttons for the server. These control whether you are live on Twitch, YouTube or any other supported stream destination.
3. Ingest controls. Mute buttons, current bitrate and a fix button used in case of buggy or non-responsive ingest.
4. Scene switcher controls. You'll start with the default three: Ingest, Ingest Low-bitrate, and Ingest Offline.
5. Screenshot pane gives you a periodic glimpse at what the server is currently receiving on the ingest.
6. Bitrate graph gives you a 1 minute historical look at your ingest's bitrate.
7. Server streaming status, uptime and bitrate status at the bottom for convenient at-a-glance updates

The bitrate graph and server status footer will only reflect the state of the Main Ingest.

OBS

Scene Collections

This list will be populated by the scene collections you create in the Remote OBS.
By default it will only have default-sc.
Currently, you cannot import scene collections made elsewhere.

If you plan on creating multiple Scene Collections, it is recommended to duplicate default-sc before making any changes so you can continue to use it as a clean template.

Remote

A cloud implementation of OBS.
Much of your server customization can be done through here.

Create new scenes, add and modify almost any source available to vanilla OBS in the same way you would on a PC.
However, many other settings will be locked and grayed out on this custom build of OBS.

The three default scenes Ingest, Ingest Low-bitrate, Ingest Offline cannot be renamed and are required for the automatic scene-switching system.

Included plugins are: StreamFX, Advanced Scene Switcher, and pango
Additional plugins may be added by request, however, they must be compilable on Linux.

Uploading Media

Click the ☰ button in the top right of the remote to open the side bar.
Drag files into the box to upload them to the remote server.
Uploaded files will appear in the dependencies folder.

Clipboard

In order to transfer clipboard contents you must grant the site clipboard access upon opening the remote.
Simply copy from your own desktop then paste into the remote. If it does not paste correctly, refresh the OBS remote page and try again.

Some browsers like Firefox do not expose clipboard access at all and will be difficult to use with the OBS Remote.
Chrome and Edge work the best historically. Other Chromium based browsers may work as well.

Troubleshooting

Extra things to note about Remote OBS

• Cropping a source by dragging its boundary may differ from your previous experience with OBS.
  If alt alone does not work try alt + shift together.
  MacOS does not appear to have any key combination to allow cropping through the remote, so you will have to use the Edit Transform menu to enter values manually.
• Interacting with Remote OBS will reset the idle timeout built into your IRLToolkit server (it shuts down after 10 minutes of inactivity if the server is not actively streaming).
• It is good practice to disable the preview once you are finished and return to the Dashboard.

Settings

Ingests

These are the ingest URLs and stream keys you will need so your streaming encoders and apps stream to IRLToolkit servers.
Keep this info private!!

Guides to configure specific encoders and phone apps for IRLToolkit

Main Ingest

If you only have one ingest, it is your Main Ingest.
If you have more than one ingest, you can select your Main Ingest under Ingest Locations by pushing the [Set as Main] button next to the corresponding Ingest Key.
The Dashboard screenshot preview, bitrate graph and server status footer will only reflect the state of the Main Ingest.

Some users may have an ingest named "Main Ingest" but if they have more than one ingest, it will not necessarily be their server's Main Ingest.

Destinations

You can have one Twitch destination via the connect with [Twitch] button.
Subsequent connections made with the [Twitch] button will add a new Twitch destination or update an existing one.

However, you can add as many Custom RTMP destinations as you like.
By using Twitch's Ingest Endpoints you can also add any number of Twitch destinations by adding the corresponding stream keys manually.

Only one destination can be active.

System

Auto Scene Switcher

Configure the bitrate thresholds under which you want the server to consider your feed Low-bitrate or Offline.

The Auto Scene Switching system governs only the three default scenes: Ingest, Ingest Low-bitrate, Ingest Offline.
This means that as long as the current active scene is one of these three, scene switching logic will be determined by the Main Ingest bitrate.
However, if the current active scene is not one of the three default scenes then the auto scene switcher is temporarily paused. It will remain paused until you manually change scenes to one of the three default scenes, signaling the Auto Scene Switching system to resume control.

Example Scenario 1

You turn on the server and set it to your custom made Intro scene.
You start the server and it begins streaming to Twitch.
Your viewers will be watching the Intro scene.
Now you turn on your streaming phone and verify that your server is receiving your phone's feed.
However, your viewers are still watching the Intro scene until you switch to Ingest.
You select Ingest and now your viewers can see your phone's feed but after a few minutes the network signal quality drops to 600 Kbps so the server seamlessly switches to the Ingest Low-bitrate scene.
You change locations to improve the bitrate and the server returns to the Ingest scene.

Example Scenario 2

You've been streaming outdoors for a while but need to temporarily stop the stream so you can use the toilet.
You try selecting Ingest Offline but it instantly switches back to Ingest.
This is because your phone is still streaming to the server and if the server is receiving a feed with good bitrate then the Auto Scene Switching system's programming tells it to stay on the Ingest scene.
Instead, what you should do is turn off the phone's stream.
Then you can safely stow the phone and go about your business.
The server will see that the feed was interrupted and switch to Ingest Offline automatically.
Your server will still be online and streaming.
Once you are ready, you can turn the phone's stream back on and the server will switch back to Ingest.

When Scene Switch Mode is set to Default (when streaming) it will only engage while the server itself is streaming to your configured destination, even if there is an active ingest feed.
However, if it is set to Override (always) then scene switching logic will occur according to the Main Ingest bitrate, even when the server is not streaming. But only if the scene switching system is not otherwise paused (such as when the current scene is a custom scene created by the user.
Whereas, when set to Disabled (off) the Auto Scene Switcher will never change scenes.
This may be useful if you intend to program your own scene switching logic. The built-in system was designed for RTMP ingests and as such does not take into account an SRT ingest's round-trip time (RTT) parameter.

Twitch Bot

Enabling the IRLToolkit Twitch Bot allows it to receive chat commands and report certain status changes to your designated Twitch channel.
You can list multiple Twitch channels separated by a comma ,.

obs-websocket Access

Remote control access for your IRLToolkit Remote OBS.
Allows you to monitor, control and automate with an obs-websocket client.
Currently supporting protocol version 5.
Password is required.

Available upon request. Contact @Support Bot in our Discord or email us at support@irltoolkit.com

More information on the obs-websocket GitHub

Video

Select your Remote OBS Canvas and Output resolution, FPS and bitrate.

Alerts

This is visible in the Settings menu while on the Dashboard. Enabling it will play an audio alert when the Main Ingest bitrate falls below the Low-bitrate or Offline threshold.
This may be useful for IRL streamers with the web dashboard loaded on a companion app such as Stream buddy so they can hear an audio cue when bitrate has fallen.

Password

Change your irl.run password here.