Vivoh Logo

Vivoh Media Relay General Usage

🔗

Usage: ./vivoh-media-relay

Vivoh Media Relay will receive multicast video from a source that is specified as a parameter to the playback URL, for example: http://10.0.0.1:8888/index.m3u8?s=rtp://239.0.0.1:1234

Vivoh Media Relay uses by default
VLC (https://videolan.org)
or can be configured to use
FFmpeg (https://FFmpeg.org)
Vivoh Media Relay 1.0.36
            
Usage:

vivoh-media-relay

OPTIONAL:

-p port of local web server ... eg "8888"
-i IP address to bind to.
-d temporary directory for TS files
-v use VLC as segmenter (default)
-f use Ffmpeg as segmenter

Basic Usage

🔗

Usage: ./vivoh-media-relay

Vivoh Media Relay starts VLC when the HLS stream is requested and holds open the request until the TS files are ready. When ready, it responds with the playlist.

Access this stream via: http://10.0.0.1:8888/index.m3u8?s=rtp://239.0.0.1:1234
Access player page at http://10.0.0.1:8888/hls.html?s=rtp://239.0.0.1:1234
Vivoh Media Relay 1.0.31

LEGEND

*: Starting VLC process
@: waiting, waiting for the TS files to be ready

Media Relay listening on http://10.0.0.183:8888

*@@@@@@@@@@@@@@@@.....

Custom FFmpeg extras

🔗

Usage: vivoh-media-relay-linux -f --ffmpegExtras='-c:a aac -ar 48000 -b:a 128k -c:v h264 -profile:v main -crf 20 -g 48 -keyint_min 48 -sc_threshold 0 -b:v 2500k -maxrate 2675k -bufsize 3750k -hls_time 4 -hls_flags delete_segments'

There may be times when you need to customize the FFmpeg command. You can provide extra switches with the --ffmpegExtras switch

$ vivoh-media-relay-linux -h \
--ffmpegExtras='-c:a aac -ar 48000 -b:a 128k -c:v h264 -profile:v main -crf 20 -g 48 -keyint_min 48 -sc_threshold 0 -b:v 2500k -maxrate 2675k -bufsize 3750k -hls_time 4 -hls_flags delete_segments'

Vivoh Media Relay 1.0.31

LEGEND

*: Starting FFmpeg process
.: TS files and m3u8 file ready, broadcast started
@: holding for the TS files to be ready

🛫
Listening for connections on 0.0.0.0 on port 8888

*@@@@....