FFmpeg is a versatile video utility that can process almost any video format and has a huge variety of protocols. This makes it the universal tool for bringing a lot of different sources into mimoLive, including RTSP, RTMP and SRT.
Due to licensing restrictions, FFmpeg needs to be downloaded and installed by the user separately from mimoLive.
The most convenient way to install FFmpeg is by using Homebrew, a so-called package manager for command line tools. You’ll find the most recent instructions at the Homebrew web page.
1. Open Terminal.app and copy/paste this command to install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Install FFmpeg using this command:
brew install ffmpeg
Enter the path to FFmpeg in mimoLive
Before you can use the FFmpeg source, you need to let mimoLive know where to find it.
To find out the path where ffmpeg is installed, you can use the Terminal and issue the command:
Depending on your MacOS version, this can be
/opt/homebrew/bin/ffmpeg but other paths can also exist.
Enter this path into the FFmpeg Installation Path field in the mimoLive Preferences:
Using the FFmpeg source
FFmpeg runs as a separate process controlled from mimoLive. By default, it is only launched when a layer it is used in is switched live. In some cases, this can take a few seconds.
Once started, however, the FFmpeg source receives data until the source no longer sends data regardless of whether the source is used in a live layer.
To use the FFmpeg source, add it to the Sources column:
FFmpeg Input Parameter
FFmpeg uses command line parameters for instructions of what it should do. You can enter the parameters by clicking on the edit button next to the text field showing the currently active parameters:
If you click “Save” and FFmpeg is running, the process is stopped and restarted with the new parameters. If you click Cancel, the parameters currently in use are preserved and, if it is running, FFmpeg keeps running.
See the subsections on RTSP, RTMP and SRT for examples for parameters to use.
FFmpeg will only be started when a layer it is assigned to is switched live. If you want to run FFmpeg as a server, for example to receive live camera streams via RTSP, RTMP or SRT, checking this checkbox will start FFmpeg immediately and keep it running as long as mimoLive is running regardless of whether the input is actually used by a live layer.