This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Stream Monitor

    The Stream Monitor continuously checks one or more Internet audio streams, and plays them as soon as they become available. A typical use case is a remote DJ who broadcasts live from home: The DJ sends a stream to a streaming server, mAirList detects it, and the live show automatically goes on air instead of the regular program. When the DJ stops streaming, mAirList automatically returns to the regular program.

    How It Works

    For each configured stream, the Stream Monitor regularly tries to connect to the stream URL. Each stream has one of the following states:

    • disabled: The stream is not being monitored (e.g. because the Stream Monitor is not running in this application).
    • offline: The stream is currently not available.
    • available: The stream is available, but not on air, because another stream with a higher priority is on air.
    • on air: The stream is being played.

    If more than one stream is available, only the one with the lowest Priority value is played. If two or more streams with the same priority are available, all of them are played at the same time.

    The streams are played on the Stream Monitor playback device, which is configured in the Audio Routing. Usually, this device is connected to the High Priority Input of the encoder, which automatically fades out all other signals while the stream is on air. Alternatively, you can route it to a sound card output and feed it into your mixing console.

    Title updates (metadata) received from the stream are logged like the titles of any other item, and can be forwarded to the encoder connections (see the option Forward song title updates of relayed streams in the encoder connection settings).

    Every change of a stream’s state is recorded in the System Log.

    Configuration

    The Stream Monitor is configured on the Stream Monitor page of the configuration. This page is also available in the live configuration (mAirList Control Panel).

    Streams

    The list contains all monitored streams. Use the toolbar to add, configure, or remove streams. Each stream has the following settings:

    • Stream URL: The URL of the stream, e.g. https://stream.example.com/live.
    • Description: An optional name for the stream, which is displayed in the status display and the System Log.
    • Priority: Determines which stream goes on air if more than one stream is available. Lower values have higher priority. The default is 1.
    • Check interval (seconds): How often mAirList tries to connect to the stream while it is offline. The default is 5 seconds.

    Actions

    On the Actions tab, you can configure actions that are executed when the Stream Monitor goes on air (i.e. the first stream becomes available), and when it goes off air again (i.e. no stream is available anymore). Select When on air or When off air to edit the respective action list.

    For example, you could disable automation while a remote show is running, or insert a jingle when the program returns to the studio.

    Status Display

    To display the state of the monitored streams in the playout window, add a Stream Monitor Status screen object in the GUI configuration. It shows the list of streams, along with their priority and current state.

    The status of the Stream Monitor can also be retrieved from the REST API (/streammonitor/summary).