Medusa Panel › Stream › Add Stream
An IP source is any feed the engine pulls or receives over the network. You name it with a URL in the Source Stream field, and the scheme of that URL decides the protocol. Sources are tried in order, so put the preferred one first and backups below it.
Source forms
The engine recognises these Source Stream URL forms:
| Source | Use | Example |
|---|---|---|
| HTTP / HTTPS | HLS, DASH or HTTP-TS | https://source.example/live/index.m3u8 |
| UDP / RTP | Unicast or multicast transport stream | udp://239.10.10.10:5000?localaddr=192.0.2.10 |
| RTSP | Camera or contribution source | rtsp://user:password@source.example:554/path |
| RTMP / RTMPS | An existing RTMP publisher | rtmp://source.example/app/name |
| SRT | Reliable contribution over an unreliable network | srt://source.example:9000?mode=caller&latency=120000 |
| TCP | Raw TCP contribution | tcp://source.example:9000 |
| DVB | A service discovered by a tuner adapter | dvb://server=1&adapter=2&sid=101 |
| Local RTMP publish | Let a publisher such as OBS push into the engine | rtmplocal://a-unique-token-at-least-16-characters |
| Local file | A file readable by the selected server | /data/input.ts |
rtmplocal://<token> (16–128 letters, numbers, dots, underscores or hyphens) and have the encoder publish to rtmp://server:port/stream/<token>.Query parameters
You can append engine options to an HTTP(S) or manifest source as URL query parameters. Start with ?, or & if the URL already has a query. The engine removes the options it recognises before opening the source; any it does not recognise stay on the upstream URL. Names are case-sensitive.
https://source.example/manifest.mpd?token=value&ignore_subtitles=1
decryption_key— source decryption keys (aKID:KEYpair, or comma-separated pairs) for an encrypted source manifest.ignore_subtitles—0or1; drop the manifest subtitle tracks.segment_with_manifest_params—0or1; copy the manifest query onto segment requests.segment_with_proxy—0or1; fetch segments through the source proxy as well.http_proxy— a proxy URL for this HTTP source; overrides the Proxies selection.http_persistent—0or1; keep the HTTP connection alive between requests.headers— extra request headers, joined with the literal\r\n, for exampleheaders=Name: value\r\nName2: value.stream_loop—-1for endless, or a count; loop a finite source such as a file.language— a language tag for a.srtor.assinput.
Backup sources
Add more URLs (URL #2, URL #3 …) as backups. If the active source drops, the engine fails over to the next one and back again when it recovers.
Source options (form fields)
- HTTP User-Agent, HTTP Referer, HTTP Headers — sent when opening an HTTP(S) source that requires them.
- Proxies — pull the source through a configured source proxy — see Add Proxy.
- HTTP Local Address — bind outgoing HTTP(S) requests to a local interface;
Autolets the OS choose. - Format Flags — advanced FFmpeg input-format flags for awkward sources.
- Timeshift, Sleep Schedule, Restart Schedule — timing controls for the input.
Once the source is set, transcode it or pass it through — see Codecs and passthrough.
Related
- Add Stream — the full stream form.
- SAT>IP — a network tuner reached over IP.
- DVB tuners — ingest from a local tuner card.
- HDMI and SDI sources — bring a baseband feed in over IP.
- Codecs and passthrough — what to do with the source.