Configuring a Device

Each device tends to require a little fine-tuning to get configured just right.

Prerequisites

The device is already connected to the network. This means you have completed the manufacturer's setup process.

To add a device to StreamShuttle, head to the "Devices" section in the main menu. Then click the "Add New Device" button. It is usually a good idea to import the device using the ONVIF protocol via the "Configure Via ONVIF" button. This automatically imports most of the settings required to get the device up and running, including the PTZ configuration.

When initially creating a device, not all configuration areas are available. You will see all configuration sections after saving. Simply add a "Name" and click "Create" to continue with all sections available.

Add a device using ONVIF

Successful StreamShuttle ONVIF scan showing connection fields and detected camera settings

At a minimum, you usually need to know the camera's IP address. You can normally find it in the device details in the manufacturer's app or by reviewing the DHCP clients in your home router. You may also need a username and password, depending on the camera manufacturer.

Once you have entered these details, press the "Scan" button. After a few seconds, the Probe result area should show a "Success" badge and the detected camera settings. You can expand "View raw response" when you need the complete response for troubleshooting. If the scan succeeds, click the "Import" button and move on.

If the Probe result area shows "Error," StreamShuttle cannot import the configuration and the "Import" button remains unavailable. An error message appears below the badge. Its wording depends on the connection failure and the manufacturer.

Add a device manually

If the ONVIF scanner does not detect your device, try scanning without credentials or search for whether your device uses a non-standard port. If you still have no luck, enter the connection details manually. You can usually find them by searching for the device model number and "RTSP URL" or "RTSP connection settings" in any search engine.

Once you have entered the connection settings, click the "Create" button before continuing to configure the device. This enables the "Probe" option, which can help determine whether the device is configured correctly.

Unfortunately, there is no single method that applies to all cameras or devices, so you may need to research your device's defaults. This is another good reason to stay with one manufacturer when choosing devices, since the setup process is usually similar across all its devices.

Check the Device docs for more information.