Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
To set up your Restreamer, you need to open the graphical user interface in a browser and log in with your credentials.
πͺ The wizard helps with the initial setup and configuration of the video sources in the datarhei Restreamer. All settings can be edited at any time afterward on the grounds of the live stream.
After entering the datarhei Restreamer graphical user interface for the first time, you can use the wizard to set up a video source. The wizard will help you to configure the single steps conveniently.
You can edit all settings at any time later on.
The wizard can be started again in the first step or directly in the audio settings in the live stream settings.
Select whether to retrieve the video source from a network source (such as a network camera) or from the internal RTMP server (such as OBS Streams or Wowza).
Push method Enter the address for the video source. HTTP, HTTPS (HLS, DASH), RTP, RTSP, RTMP, SRT are supported. The manufacturer in the manual specifies the streaming address of network cameras.
If you use OBS or another video source, use this address as the video source.
If you have an active Raspberry Pi Cam, use this address as a video source.
If you want to use a video device via USB.
Internal SRT server
Select one of the available video profiles of the video source.
This step sets the audio from the live stream.
A silent audio channel is recommended if you don't have sound, but an audio track is necessary to produce the video. Some services like YouTube or Facebook always require an active audio channel.
Disable the sound.
Enable Sound
Metadata is essential for the search engine optimization of a video. Therefore, a short description of the video for the audience is optimal.
Think briefly about the terms under which the video will be published on the Internet. All Creative Commons licenses are supported. The Creative Commons page explains the details of the different licenses in detail.
The worst license is no license!
CC0 1.0 The person who has associated a work with this deed has dedicated the work to the public domain by waiving all of their rights in the work worldwide under copyright law, including all related and neighboring rights, to the extent permitted by law. You may reproduce, modify, distribute and perform the Work, including for commercial purposes, all without asking permission.
CC BY 4.0 This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format as long as credit is given to the author. The license permits commercial use.
CC BY SA 4.0 This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format as long as credit is given to the author. The license permits commercial use. If you remix, adapt, or build upon the material, you must license the modified material under identical terms.
CC BY NC 4.0 This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format and for non-commercial purposes only, as long as credit is given to the author.
CC BY NC SA 4.0 This license permits reusers to distribute, remix, adapt, and build upon the material in any medium or format for noncommercial purposes only, and only so long as credit is given to the author. If you rework, adapt, or build upon the Material, you must license the modified Material under identical terms.
CC BY ND 4.0 This license allows reusers to copy and distribute the material in any medium or format only in an unadapted form and only as long as credit is given to the author. The license permits commercial use.
CC BY NC ND 4.0 This license permits reusers to copy and distribute the material in any medium or format only in an unmodified form and only as long as credit is given to the author. The license permits commercial use.
Check and control all device settings.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
The expert mode extends the configuration possibilities.
The node ID can be used to uniquely identify the running datarhei core.
The name makes it easier for people to identify the core. In addition, it is generated automatically or can be customized.
Enable automatic check for updates.
Once a Core is connected to the service, the service will notify you of updates.
In the expert mode, you have access to all functions of datarhei Restreamer, including the export of databases or the encryption of external files. Due to the significantly extended range of functions compared to the beginner mode, the expert mode is primarily intended for users who already know the program and want its full range of functions.
Restarting the Core.
Do not forget to save the settings.
Unsaved settings will be lost by aborting.
Closes the active window without saving.
The wizard can be started again in the first step or directly in the in the .
Register your datarhei Core at datarhei Service for free.
Follow us on Twitter or YouTube and sign up for our newsletter, so you don't miss the launch of the datarhei service.
Twitter twitter.com/datarhei YouTube https://www.youtube.com/user/datarhei Newsletter https://datarhei.com
Control area for the compilation of statistics of the users.
Settings for playback are only visible in expert mode.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
Enable or disable Allow access from all referrers.
The HTTP request header "Referrer" contains the page's absolute or partial address from which the request originates. The referrer header allows a server to identify a page from which it is visited. This data is used by datarhei Restreamer to bring essential protection to the live streams.
The access control takes effect when the hook is deactivated, and a domain is entered.
Syntax: One address per line. The default value is allow all: *
Accept all accesses.
The audience count is displayed when the hook is active.
To exclude viewers from the statistics, it may be necessary to ignore IP addresses so that the statistics are not distorted. For this purpose, a list of IP ranges in CIDR notation can be created in the text field, e.g., 127.0.0.1/32, which are not covered by the statistics.
Syntax: One IP range per line.
Record all sessions: Leave field empty
Length of the time interval in seconds when the viewer's session is terminated to no longer be captured by the statistics.
The default value is: 30 seconds
Session data is stored on the hard disk of the core host system.
After logging in with your credentials, the home page appears on the main screen.
On the main screen, you can see the current video stream. Under the video player, you can find the runtime, the bitrate, and the frame rate. In addition, you find the number of viewers and the current bitrate in real-time for the publications.
The navigation points take you to the settings of the various submenus.
System menu
datarhei Service
Issue alert
Language
Logout
All
Plattform
Software
Protocol
Add source
Switch channel
Embed
Color
Logo
Statistics
Playback
Process details
Stop Stream
Copy HLS, RTMP, SRT, or Snapshot address
Check the credentials for the administrator and in the expert mode for IP addresses.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
If access data are activated via ENV, a change via the graphical interface in the Restreamer is not possible.
It is strongly recommended to enable authorization to prevent unauthorized access to the instance.
Here you can store the name for the login.
Password for authorization on the system.
Configure basics for a functioning network.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
The publicly accessible domain name of the host on which this Restreamer is running. Separate multiple domain names with commas. The default value is: demo-core.datarhei.com
Address on which HTTP requests should listen. The default value is Port: 8080
Address on which HTTPS requests should listen. The default value is Port: 8181
Letβs Encrypt requires one or more public domain names and an accessible port 80/TCP. The HTTP port is changed automatically.
Sets a limit for viewers in an HLS session. Once the limit is exceeded, HLS viewers receive the HTTP status code 509 (bandwidth limit exceeded).
The default value is unlimited: 0
Sets a bandwidth limit in Mbit/s for outgoing HLS data transmission. All services and outgoing processes are included in the calculation. Once the bandwidth is exceeded, HLS viewers receive the HTTP status code 509 (bandwidth limit exceeded).
The default value is unlimited: 0
The log file can assist in targeted troubleshooting.
These settings are only visible in expert mode.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
Copies the system log to the clipboard.
Different levels of logging. There are five different levels.
Silent
Error
Warn: Errors and warning messages
Info: Errors, warnings, and information messages
Errors, warnings, information messages, and debug information
The number of log lines.
Number of most recent log lines to keep for each process.
Number of most recent log lines to keep for each process.+
Configuration settings for the internal RTMP server.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
RTMP and RTMPS are supported simultaneously.
The β checkmark activates the RTMP server.
The β checkmark activates the RTMPS server.
Port settings for the RTMP server.
The default value for the listening address is port: 1935
Port settings for the RTMP/S server.
The default value for the listening address is port: 1936
The RTMP application name is a path prefix for the stream name for publishing and playback. This is sometimes required by RTMP clients. It can be an arbitrary name (e.g. /foobar
) and will be prefixed to the stream name (e.g. /foobar/live.stream
).
RTMP token for publishing and playback. The token is the value of the URL query parameter 'token'.
Secure Reliable Transport (SRT) is an open-source video transport protocol that utilises the UDP transport protocol.
Docker port mapping must be extended for this as well. The unique thing is UDP, which you build into the command as follows: -p 6000:6000/udp.
By default Docker always uses TCP for the ports. So if you forget /udp, you will not be able to reach the SRT.
The β checkmark activates the SRT server.
Port settings for the SRT server.
The default value for the listening address is port: 6000
SRT token for publishing and playback. It is a protection against unwanted inputs/outputs. The token is the value of the URL query parameter 'token'. This setting is optional.
This setting encrypts the stream and is optional.
The Restreamer provides comprehensive system monitoring.
A video stream for viewing.
The number of the current audience.
in Mbit/s
Operating time is the duration of time the active livestream is used in hours, minutes, and seconds.
Bitrate of the active live stream
Frames per second β short FPS.
You can control the saving of videos in this section.
Settings for the memory space are only visible in expert mode.
Locked settings that have been set with environment variables at startup are marked with ENV. Disable or adjust environment variables unlocks the settings.
Basic authentication for PUT, POST and DELETE requests. It is strongly recommended to enable basic authentication to prevent unauthorized writes to /memfs.
datarhei Restreamer provides a ready-made website for easy and quick presentation of the live stream. The publication website is equipped with a video player and ready to go.
Design of the publication website with various modules.
The current default template cannot be deleted. If new templates are uploaded, they appear in a dropdown.
Delete available templates.
Give the template a pretty name!
The button uploads the template.
Opens the publication website in a browsertab.
Save the publication website settings.
Customize colors and background of the publication website.
RGB or web colors may be entered.
Color for general text.
For all headlines in title, channels, modal box.
The link color in the texts.
Hover color when hovering the mouse cursor over it.
The background color of the web page.
Color for the title bar
Color of the active tile in the channels. Only active for multiple live streams.
Color of the inactive tile in the channels. Only active for multiple live streams.
Line color defines the color of the horizontal lines.
Upload background image as JPEG or PNG. Recommended resolution 1280x720 px. The address to the image will be displayed.
Opens the publication website in a browser tab.
Save to save the settings.
The default template is available at .
The publication service helps you send video output to a remote station. It is a virtual broadcast to deliver a live video to many or single destinations.
Default In this case we use the HLS stream of the channel and push it to the desired destination. Latency: What the user has set (min. 10-30 sec.)
Take the stream from the RTMP server if the channel is enabled as shown in "2. Channel Edit > Processing & Control". Latency: 1-2 sec.
As for RTMP. Latency: <1 sec.
An active user account on the external video streaming service is a prerequisite for using Publication Services.
Instructions for the settings of the target services can be found on the target platform. Keywords for research are: "External RTMP" or " External HLS".
There are many Publication Services. Any number of new services can be created for different platforms. The procedure for using publication services is always very similar. The datarhei Restreamer is connected to the external service via a streaming key. Then the video stream is started on the service, in this example, YouTube.
If a platform for distributing your content is missing, don't hesitate to contact us. We will add the publication service immediately. Just submit a pull request via GitHub or write an email to support@datarhei.com.
YouTube
Twitch
Vime
TikTok
Amazon
Telegram
dlive
Trovo
PeerTube
livespotting.com β The #1 webcam platform for webcams in Germany
restream.io β Multi-Channel Platform
be.live
BrightcoveΒ βΒ OTT
Akamai - CDN
DaCast - OTT
CDN77 - CDN
Azure Media Services - CDN
Media Network
WOWZA
Icecast
Red5
Ant Server
Mist Server https://www.mistserver.org/opensource
Kurento https://www.kurento.org
Streamhash https://streamhash.com
Clipbucket https://clipbucket.com
FreeSwitch https://freeswitch.com
Nimble Streamer https://wmspanel.com/nimble
Xsplit https://www.xsplit.com
Wirecast https://www.telestream.net/wirecast/
Unreal Media Server http://www.umediaserver.net/umediaserver
NginX with nginx-rtmp-module
Owncast https://owncast.online
Image2
RTSP
RTMP
HLS
DASH
SRT
UDP
MPEG-TS
Framebuffer
If connection problems occur, error diagnostics can be performed via the error logs of the process details and the process report.
Create, manage and delete additional video sources.
Activate additional video sources via the interface in the browser in just a few steps.
The icon opens an additional layer at the bottom of the screen.
The wizard starts to create the new video source. After successful creation and saving, the latest video source appears in the bar (video bar) at the bottom of the screen.
Active video signals appear in the video bar at the bottom of the screen.
Collapses the video bar.
Each video source is deleted from the settings menu of the respective live stream.
Customize imprint and terms of use in the footer of the publication website.
The link to the imprint becomes active in the footer when a text is placed in the text field and saved.
The link to the terms of use becomes active in the footer when a text is in the text field and is saved.
Opens the publication website in a browser tab.
Save to save the settings.
Edit the audio and video sources, determine their processing, add metadata, and define the desired license.
The sources menu section shows the active video and audio settings per channel.
Use the wizard for quick and easy setup, or edit sources directly in custom mode.
π§Start the video source wizard.
Adjust the active video settings
π§Starts the wizard for the audio sources
Customize the active audio settings.
Unsaved settings are lost by canceling.
The active video source is completely removed from the system.
Do not forget to save settings.
Closes the active window without saving.
Send and receive video signals from USB devices.
The "USB Video Class" (UVC) includes devices that transmit video over USB and groups them into a specific class of USB devices. These include webcams, camcorders, transcoders, and devices that convert analog tapes to a digital format. These types of video sources are displayed as video sources in the datarhei Restreamer's graphical user interface and are active for live streaming with a few simple steps.
The custom code injection helps use external widgets or styles for advanced users. You will find some example code on the help page.
Insert code in the header style. Code at the end of the body, for example, to use external scripts.
Insert code in the channel list.
Insert code between the description of the live stream and the author's name. An example, for a comment widget or social media widget.
Insert code into the header style.
Opens the publication website in a browser tab.
Save to save the settings.
With the help of the test signals, it is possible to test a transmission system, check for stability, or determine properties.
Various signals, such as βGame Of Liveβ are available as an option with S23/B3 rule for test operation. FPS and size can be adjusted depending on the signal.
Test pattern
Test pattern extended
RGB test pattern
YUV test pattern
EBU PAL 75%
EBU PAL 100%
SMPTE EG 1-1990
SMPTE RP 219-2002
Game of Live
Frame rate refers to the number of frames captured or played back per period and is specified in units of FPS (Frames Per Second), BpS (Frames / Frames per Second), or Hz (Hertz). Default value is in 25 / 30 / 50 / 60 FPS.
A resolution that corresponds to a display device's resolution (number of pixels) is called native resolution. The Restreamer works best with 16:9 resolutions.
After a successful check, more details and the encoding settings can be shown.
Use audio signal with the video channel from the network.
Silence
Noise
Sine
We recommend the standard sampling rate of 44100 Hz.
96000 Hz
88200 Hz
48000 Hz
44100 Hz
22050 Hz
8000 Hz
Custom β¦
Sampling rate of the audio stream.
Stereo and mono support.
After selecting the settings, the audio stream must be checked. The setting can only be saved after a successful check.
> CHECK If the audio source is not accepted, the error message can be displayed directly. By clicking on: "View details of the check".
There are different types of camera boards for the Raspberry Pi. The official Raspberry Pi cameras can take high-resolution photos and Full HD 1080p videos and be fully controlled programmatically. After installing the "raspi-config" menu, all cameras can be used in the Restreamer for livestreaming.
Send and receive video signals from a network on the LAN or WAN.
Fetch or receive data? There are two different variants to choose from as a mode: Push or Pull. The respective setting influences the further menu navigation.
You can select between > SRT > RTMP or > HLS.
Enter this address in the sending device from the video signal.
Pressing the button verifies the reception of the video signal.
If the stream is not accepted, the error message can be displayed directly. By clicking on: "View details of the review".
At this point, the address of the server can be customized. The address supports HTTP, HTTPS (HLS, DASH), RTP, RTSP, RTMP, and SRT.
If required, the access data of the video source can be entered here.
Read input at native speed
Force input frame rate
This option sets the maximum number of packets in the queue when read from the file or device. For low latency/high rate live streams, packages may be discarded if they are not read in time; setting this value may force FFmpeg to use a separate input thread and read packets as they arrive. The default value is 512.
Default value is: genpts
discardcorrput -> Discard damaged frames
fastseek -> Enable fast but inaccurate searches for some formats.
genpts -> Generate the timestamp of the video
igndts -> Ignore decoding of the timestamp
ignidx -> Ignore index
nobuffer -> Reduce latency caused by optional buffering
nofillin -> Do not fill in missing values that can be calculated exactly
noparse -> Disable AVParsers, that needs filling too
sortdts -> Try to interleave the output packets by decoding the timestamp
After starting the test process, the active video stream can be selected.
"Show probe details" shows the feedback from the system.
Passthrough (copy) option takes the unedited video stream.
Passthrough (copy) option takes the unedited video stream.
H.264 (libx264) starts a video encoding with the free and open-source software library.
Afterwards, you can directly switch to the audio settings.
The audio settings for a virtual audio source.
Silence
Noise
Sine
We recommend a sampling rate of 44100 Hz.
96000 Hz
88200 Hz
48000 Hz
44100 Hz
22050 Hz
8000 Hz
Custom ...
Sampling rate of the audio stream.
Stereo and mono support.
After selecting the settings, the audio stream must be checked. The setting can only be saved after a successful check.
Pressing the button verifies the reception of the video signal.
In situations where something doesn't quite work as expected, we can help you troubleshoot the problem using the information from the process report.
GDPR! All IP addresses and access data are stored anonymously.
When you have problems and request help from datarhei online helpdesk or on GitHub, the most common source of information requested is the process report. This report contains system information, user access, event log, settings list, and network configurations. The settings list can include user IDs but not passwords or IP addresses.
Click Process Report, save it as a .txt file, copy the data to the cache, and attach it to the case.
The video player is part of the Publication Service for the website and the publication website.
The iFrame is the HTML element used to embed the video player with the live stream on web pages. We recommend keeping the aspect ratio of the video stream so that the video plays correctly.
The customization of the colors of the video player. The syntax used is the standard for colors in HTML in hex color code (#fcee21)
A logo for branding with a graphic in PNG or JPEG format is done using the button. After the process, the public path to the picture appears. Using the dropdown menu, the position of the graphic in the corners of the player and a link can be assigned.
A poster as a snapshot alternative with a graphic in PNG or JPEG format is done using the button. After the process, the public path to the picture appears.
Google Analytics tracking is activated via the GA code. You can find the code in your Google account. A new window appears in the video with various details with additional interesting information. There you can see technical details like the video ID, the resolution, the connection speed, and the volume. The values can be interesting for various purposes, such as technical curiosity or content creators who want to compare their videos with other content.
Select the options for the live stream.
Autostart video automatically starts the live stream.
Turns off the audio channel.
Start broadcasting with Chromecast.
Start broadcasting with Apple AirPlay devices.
datarhei Restreamer uses FFmpeg for streaming and stores log files for each video process for diagnostic purposes.
Log data of the running FFmpeg process.
The most important raw data of the active live stream is in real-time.
FPS is the frames per seconds
Quality stands for the Speed of the video encoding
1 = normal
< 1 = too slow
1 = too fast when data is jammed
Lost frames
Duplicate frames
General characteristics of the process control of the livestream.
HTTP live streaming (HLS) is an industry-standard video streaming protocol.
Selection of the storage location in the working memory or on the hard disk.
Selection of HLS version for different requirements.
Version 3 is recommended and is standard.
Version 6 is with guaranteed iFrames for each HLS chunk. Some players require this.
Version 7 is with fragmented MP4 files. MPEG-DASH has been adapted.
The unit for segment length is in seconds. The segment is cut at the next keyframe after this time has elapsed. We recommend using the value 2 as the default value.
The maximum number of playlist segments. The value 0 will contain all segments. As a default value, we recommend using the value 6.
Master Playlist option (default is active). This Increases player compatibility.
Automatic cleanup of all media data after the end of the process.
Publish the stream as an RTMP output.
Publish the stream as an SRT output.
A preview image is generated from the live stream.
The interval is in seconds and specifies the value until the video source's preview image (JPEG) is updated. As the default value, we recommend 1 minute, 60 seconds.
Behavior rule for the running video process in case of a malfunction.
The checkbox is used to decide whether the stream should reconnect or not.
Interval in seconds until the connection starts again.
Seconds until a hanging process is terminated and exited as Faulty.
Unsaved settings are lost by canceling.
Do not forget to save settings.
Closes the active window without saving.
The system monitoring measures and observes the most critical system functions from the host system in real-time. If threshold values reach binding regions, the system warns.
A brief description should explain what the audience can expect as precisely as possible.
A short and accurate name will help search engines index the video stream. The video's description will also help the audience understand the content. The title should not exceed the character length of 55 characters.
The information about the video producer on the player page.
When you switch from content to author, the field is changed.
When switching from content to author, the field is changed.
Besides the player, the Restreamer offers a complete publication website, for easy and quick presentation of the live stream.
Check the box to make the index.html page accessible from the home directory.
Sets the name of the publication website for the header and page title.
Choose the default video channel for the publication website. This selection is only available if more than one video channel is active.
Activate the sharing function on the Publication website.
Plays the video stream on Chromecast devices.
Plays the video stream on Airplay devices.
Support for datarhei Restreamer in footer. Thank you. πΎ
The button leads directly to the index.html of the publication website.
Do not forget to save the settings.
Use as screen capture monitor
Works - but is only used for native installations and is not officially supported by us yet. But don't worry, this will be added very soon.
Follow us on Twitter or YouTube and sign up for our newsletter to not miss the launch of this feature.
Twitter https://twitter.com/datarhei YouTube https://youtube.com/user/datarhei Newsletter https://datarhei.com
Use the Creative Commons (CC) license for each livestream.
The Creative Commons (CC) license is one of several public copyright licenses that allow free distribution of an otherwise copyrighted "work." A CC license is used when an author wants to give others the right to share, use, and build upon a work they (the author) have created. CC provides flexibility to an author (for example, they might choose to allow only non-commercial uses of a particular work) and protects people who use or redistribute an author's work from copyright infringement concerns, as long as they abide by the terms stated in the license with which the author distributes the work.
Depending on which license you choose, a logo will be generated for the website.
The person who has associated a work with this deed has dedicated the work to the public by waiving all of their rights in the work worldwide under copyright law, including all related and neighboring rights, to the extent permitted by law. You may reproduce, modify, distribute and perform the Work, including for commercial purposes, all without asking permission.
This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format as long as credit is given to the author. The license permits commercial use.
This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format as long as credit is given to the author. The license permits commercial use. If you remix, adapt, or build upon the material, you must license the modified material under identical terms.
This license allows reusers to distribute, remix, adapt and build upon the material in any medium or format and for non-commercial purposes only, as long as credit is given to the author.
This license permits reusers to distribute, remix, adapt, and build upon the material in any medium or format for noncommercial purposes only, and only so long as credit is given to the author. If you rework, adapt, or build upon the Material, you must license the modified Material under identical terms.
This license permits reusers to copy and distribute the material in any medium or format only in an unmodified form and only as long as credit is given to the author. The license permits commercial use.
This license permits reusers to copy and distribute the material in any medium or format in an unmodified form for non-commercial purposes only and only as long as credit is given to the copyright owner.