Most errors have only a tiny cause and are easy to fix. What you have to check first is described in this document in 3 steps.
Most problems occur in one of these three sections.
Video-Input
Player-Streaming
Publication-Service
The following standard troubleshooting procedure is proven to find a quick solution before contacting us.
As a first procedure, check whether the error also occurs with a test transmission
Look into the process details and find the error to fix it.
If steps 1 and 2 were unsuccessful, create a Github issue and attach the process report.
Describe the problem as detailed as possible. The more information you give us about your project, the better we can find a solution for you that fits your setup and will solve your problem.
Always attach the process report to your issue.
These encoders work well with the Restreamer.
OpenMAX™ is a royalty-free, cross-platform API that provides comprehensive streaming media codec and application portability by enabling accelerated multimedia components to be developed, integrated, and programmed across multiple operating systems and silicon platforms.
Video processing with a maximum of 1920x1080 pixels.
Video4Linux (V4L2) is a collection of device drivers and an API for supporting real-time video capture on Linux systems.
Video processing with a maximum of 1920x1080 pixels.
Nvidia NVENC is a feature in Nvidia graphics cards that performs video encoding, offloading this compute-intensive task from the CPU to a dedicated part of the GPU.
VA-API (Video Acceleration API) user-mode driver for Intel GEN Graphics family VA-API is an open-source library and API specification which provides access to graphics hardware acceleration capabilities for video processing.
VideoToolbox is a low-level framework for macOS that provides direct access to hardware encoders and decoders. In addition, it provides services for video compression and decompression and conversion between raster image formats stored in CoreVideo pixel buffers.
x264 is a free and open-source software library and a command-line utility developed by VideoLAN for encoding video streams into the H.264/MPEG-4 AVC video coding format.
x265 is a software codec for creating digital video streams in the High-Efficiency Video Coding video compression format developed by the Joint Collaborative Team on Video Coding.
ibvpx is a free software video codec library from Google and the Alliance for Open Media. It is the reference software implementation for the VP8 and VP9 video coding formats. For AV1, a special fork named libaom was stripped of backward compatibility.
The publication service "{0}" could not be deleted
Login failed: Couldn't load API details
The channel "{0}" could not be deleted
Main channel not found
Publication service not found
RTMP server is not enabled
The input profile is not complete. Please define a video and audio source.
There was a problem storing the settings. Settings not saved.
There were some errors in the settings. Settings not saved.
This is not necessarly an error. It may take a bit longer for Restreamer Core to restart.
This source cannot be edited while it is in use. In order to continue you have to disconnect the source.
API endpoint not found. Settings not saved.
Deleting a publication service cannot be reversed. The publication will be stopped immediately.
This source cannot be edited while it is in use. In order to continue you have to disconnect the source.
Login failed: {0}
Reconnecting to Restreamer Core failed for the last {RETRIES} seconds.
Restarting the application failed.
Uploading the file failed
Uploading the logo failed
Failed to create playersite files.
Failed to create publication service ({0})
Failed to probe the source. Please check the <0>probe details</0>.
Failed to properly cleanup previous process data
Failed to refresh token: {0}
Failed to save ingest metadata
Failed to stop process
Failed to store playersize setting.
Failed to store publication service ({0})
Failed to update ingest process ({0})
Failed to update the player
Failed to verify the source. Please check the address.
Error while copying data to clipboard
There war an error during upload: {0}
There was an error connecting to Restreamer Core at {0}.
There was an error setting up the stream.
There were some errors in the settings. Settings not saved.
Login failed: Invalid username or password
Solution: Check the access data for validity.
Token could not be updated: Missing or invalid JWT token
Token konnte nicht aktualisiert werden: Missing or invalid JWT token
Solution:
Prüfen der Quelle ist fehlgeschlagen. <0>Details der Überprüfung</0> ansehen.
Solution:
Token konnte nicht aktualisiert werden: {0}
Solution:
Die Quelle konnte nicht verifiziert werden. Bitte Adresse prüfen.
Solution:
Login fehlgeschlagen: Konnte die API-Details nicht laden
Solution:
Die Daten konnten nicht in die Zwischenablage kopiert werden
Solution:
Beim Hochladen ist ein Fehler aufgetreten: {0}
Solution:
Es ist ein Fehler beim Verbinden mit der Restreamer-API bei {0} aufgetreten.
Solution:
Es gab einige Fehler in den Einstellungen. Einstellungen nicht gespeichert.
Solution:
In the user interface, there are always settings marked with ENV and locked for selection.
ENV = This value was set by an environment variable.
When starting the software via the shell, various settings can be activated. These settings are called “environment variables” and are marked with ENV. If a variable is activated at startup, it is no longer possible to adjust it in the graphical user interface.
It is not mandatory to set variables. All settings can also be configured via the graphical user interface.
The errors with the video source can be multilayered.
Troubleshooting should always start as close as possible to the video signal source. Then, if the video source is working, move away from the video source to locate the error step by step.
Check the video source with the VLC player. The free player is available for all operating systems and can play all formats from datarheiRESTREAMER. If the video source is not played correctly, check the original signal directly at the start if possible.
If you have hardware integrated with your video signal, check the hardware, such as encoders, network cameras, video mixers, and other eligible components.
If you can be sure that there are no hardware problems, check the transport paths to the destination of the video signal in the datarhei Restreamer.
Check the video source. IP cam, encoder, and other possible video sources.
Check LAN. Router, IP settings, firewall, port forwarding, and network settings in question.
Check WAN and Internet connection
In the last step, check the datarhei Restreamer settings.
Use the wizard to create the live stream again.
If you continue to have issues, the process reports and details can help narrow down what went wrong. All reports can be used as text files on GitHub or the helpdesk to get help. We always advise sending these reports along.