# SRT Source

Source: https://mimolive.com/user-manual/sources-input/remote-sources/srt-source/  
Last updated: 2026-11-16  
Section: Sources (Input) › Remote Sources  

### About the SRT Source

The SRT source receives live video and audio over SRT (Secure Reliable Transport), a protocol for sending video over unreliable networks such as the internet. Unlike the [SRT via FFmpeg](https://mimolive.com/user-manual/sources-input/remote-sources/ffmpeg/srt/) method, it is built into mimoLive and does not require an FFmpeg installation. The SRT source is available in mimoLive 6.19 and newer.

The SRT source expects an MPEG-TS stream with H.264 or HEVC video and AAC audio. Most SRT encoders and streaming apps send this format.

To create an SRT source, click the “+” button in the Sources column and choose **SRT** from the **Remote Sources** category.

### Connection Mode

In an SRT connection, one side waits for a connection (the listener) and the other side initiates it (the caller). Use the **Mode** popup to choose the role of mimoLive:

- **Caller** (default): mimoLive connects to an SRT listener at the given Host and Port, for example an encoder or an SRT server.
- **Listener**: mimoLive waits on the given Port for an incoming SRT stream. The sender connects to the IP address of your Mac. A listener accepts one sender at a time.

> **Important:** In Listener mode, the sender must be able to reach your Mac on the selected UDP port. If the sender is outside your local network, your router and firewall must forward this port to your Mac.

### Settings

- **Host**: The host name or IP address of the SRT listener, for example 192.168.0.100. This field is only shown in Caller mode.
- **Port**: The UDP port of the SRT connection. The default is 9000.
- **Latency**: The receive buffer in milliseconds. The default is 120 ms. Higher values make the connection more tolerant of network jitter and packet loss, but add delay.
- **Stream ID**: An optional stream identifier that is sent when the connection is established. Some SRT servers use it to select one of several streams. Leave it empty if your server does not need it.
- **Password**: An optional passphrase for AES encryption of the stream. It must match the passphrase of the sender and be 10 to 80 characters long. Leave it empty for an unencrypted connection. Click the eye button to show or hide the password.
- **Connect** / **Disconnect**: Starts or ends the connection in Caller mode. In Listener mode, the button reads **Start** / **Stop** and starts or stops waiting for a sender. While the source is connecting or connected, the connection settings cannot be changed.
- **Paste SRT URL** (Caller mode): Fills in the settings from an srt:// URL on the clipboard. mimoLive reads the host and port and the optional URL parameters mode, latency, passphrase and streamid. Settings that are missing from the URL are reset to their defaults.
- **Copy SRT URL** (Listener mode): Copies an srt:// URL with the local IP address of your Mac, the port, the latency and, if set, the passphrase and stream ID to the clipboard. Pass this URL to the sender so it can connect to mimoLive in Caller mode.
- **Keep Active**: Keeps the connection open even when no layer uses the source. If this option is off, the source connects automatically when it is used, for example by a layer that is live or in preview (in Caller mode only if a Host is set). It disconnects again when nothing uses it.
- **Show Log…**: Opens the SRT Log window, which lists connection events such as connecting, connected, reconnecting and errors. It works like the log window of the [FFmpeg source](https://mimolive.com/user-manual/sources-input/remote-sources/ffmpeg/).
- **Gain**: Turn on this checkbox to adjust the level of the incoming audio with the slider.

If the connection fails or drops, the SRT source retries automatically until you click **Disconnect** or **Stop**.

> **Note:** SRT via FFmpeg
>
> The FFmpeg method for receiving SRT still works. Use it if you need FFmpeg-specific options or if the SRT source cannot decode your stream, for example because it uses other codecs than H.264, HEVC and AAC.

### HTTP API

The SRT source (source type `com.boinx.mimoLive.sources.srtSource`) has the following properties that can be read and set via the [HTTP API](https://mimolive.com/user-manual/remote-control-automation/http-api/endpoints/):

| Attribute | Type | Description |
| --- | --- | --- |
| `srt-host` | string | Host name or IP address of the SRT listener. Required in Caller mode. |
| `srt-port` | integer | UDP port (0–65535). Default: 9000. |
| `srt-connection-mode` | string | `"caller"` (default) or `"listener"`. |
| `srt-stream-id` | string | Optional stream ID. |
| `srt-latency-ms` | integer | Receive latency in milliseconds (20–8000). Default: 120. |
| `srt-passphrase` | string | Optional encryption passphrase. Empty for no encryption. |
| `keep-active` | boolean | Keep the connection open when no layer uses the source. Default: false. |
| `audio-gain` | number | Linear audio gain (0.0–2.0). Default: 1.0. |
| `audio-gain-active` | boolean | Whether the audio gain is applied. |
| `connection-status` | string (read-only) | `"disconnected"`, `"connecting"`, `"connected"`, `"reconnecting"` or `"error"`. |

The source also supports these actions via `/documents/(DocumentID)/sources/(SourceID)/actions/(ActionName)`. The available actions depend on the connection mode and are listed in the `available-actions` attribute of the source:

- Caller mode: `connect`, `disconnect` and `reconnect`
- Listener mode: `start` and `stop`
