Network stream inputs
InputsAdd one
Press Add Input…, choose Network Stream, and pick a Protocol:
- RTMP: a sender pushes to this Mac. Most phone apps, streaming software and hardware encoders can send it.
- SRT, either way round: a sender pushes to this Mac, or InterDirector connects to an SRT sender that waits for a caller. Better than RTMP over a network that loses packets, such as the internet.
- RTSP: InterDirector connects to a camera. Most IP and PTZ cameras serve it.
A network stream input is a source like any other: it sits on a card, goes to Preview, takes a transition, has a strip in the mixer, and can be framed, colour-corrected and recorded on its own.
Listen for a sender
For RTMP, and SRT with Direction set to Listen for a sender, InterDirector waits on a Port for a sender to connect. The settings list the address to give the sender, one for each network this Mac is on, with Copy beside each.
Until a sender connects, the card says Waiting for a sender. When the sender stops, the input goes back to waiting and takes the next one that connects. One sender at a time for each input.
Several SRT inputs can use the same port, 9000 unless you change it: each sender goes to the input with its stream ID, so the port and the phones stay as they are however many inputs you add. An RTMP input needs a port of its own. A new one takes the next free port, and if two end up on the same one, the settings say so and offer Use Next Free Port. The sender must then use the new port too.
The first time an input listens, macOS may ask whether InterDirector may accept incoming connections: allow it, or nothing can reach the input. Nothing listens while the input is stopped.
The RTMP stream key
Every RTMP input has a Stream key of its own, made when you add it. Only a sender using that key is taken; a push with any other key is refused, and the card goes on waiting. Press New Key to make a new one: a sender still using the old key is no longer accepted.
The address shown ends in /live/ and the key. Many senders ask for the server and the key separately: give the
server as the address up to and including /live, and the key on its own.
Connect to a URL
For RTSP, and SRT with Direction set to Connect to a URL, enter the stream’s URL, such as
rtsp://camera.local:554/stream1 or srt://encoder.local:9000. InterDirector connects when the input starts, and
reconnects on its own if the stream goes away.
A camera that asks for a user name and password takes them in the URL, as rtsp://user:password@camera/…. RTSP is
received over TCP, so a busy network cannot silently break up the picture.
SRT stream ID and passphrase
An SRT sender presents a Stream ID, and a Passphrase encrypts the stream. Both must be the same at both ends; a passphrase is 10 to 79 characters.
A new SRT input that listens has a Stream ID of its own, made when you add it, as an RTMP input has its key. Only a sender presenting that stream ID is taken; one presenting another, or none, is refused, the card goes on waiting, and the Show’s journal notes it. Press New ID to make a new one: a sender still using the old one is no longer accepted. Clear the stream ID to take any sender that no other input on the port expects, as SRT inputs added with earlier versions still do.
Each input keeps its own passphrase and latency. Two inputs on one port cannot have the same stream ID, or both none: their settings say so, and New ID mends it. If a sender connects again with the stream ID of one already connected, such as a phone back after a dropout, the new connection takes over straight away.
The stream key, the passphrase and any password in a URL are saved with your Show. Anyone with the Show file can read them, and push to its RTMP inputs.
Network timing
Latency is Automatic, or a number you Set. Raise it if the picture or sound stutters; lower it where the network is reliable and you need the picture sooner.
- For RTMP and RTSP it is how far behind its arrival the stream is played, to ride out the network’s hiccups. Automatic is 500 ms.
- For SRT it is SRT’s own window for resending what the network lost; a sender asking for more gets more. Automatic is 120 ms for an SRT input that listens on this Mac, and 500 ms for one pulled from a URL or coming over the internet. After the window, the stream is held a while longer, because many senders send their sound in bursts: 80 ms for InterDirector Cam on this network, and for any other sender the latency again, or 500 ms on Automatic. So InterDirector Cam on the same Wi-Fi plays about 200 ms behind the phone on Automatic.
Timing, as for NDI inputs, chooses whether the stream follows the sender’s clock or is placed by its arrival. Automatic follows the sender’s clock for a stream with a picture.
Input delay, under the input’s Timing, is separate, and is still what lines the stream up with your other sources.
Set a phone up from a QR code
For a listening RTMP or SRT input, and one over the internet, the settings have a button for each phone app, InterDirector Cam QR Code… and Larix QR Code…, which opens its QR code in a window of its own. On your network, the code carries your Mac’s main network address. If your Mac has more than one address, choose the one on the phone’s network at the top of that window:
- InterDirector Cam, InterDirector’s own iPhone camera app: scan it with the app’s Scan InterDirector’s QR Code button, in Settings › Connection. It sets the connection and the Show’s frame rate and resolution (4K for a 4K Show, 1080p for a Full HD or larger one, 720p for a smaller one), and replaces whatever the phone was set up for before. With Adaptive bitrate on in the app, the phone lowers its bitrate not only when its own upload struggles but also when its picture falls short on the way to InterDirector: InterDirector tells it, and so does the relay over the internet, and it climbs back once things hold. The Show journal says when a phone was asked to lower it, and when it is back.
- Larix Broadcaster: scan it with the phone’s camera and Larix adds the connection: the address, the stream key or the SRT stream ID and passphrase, and an SRT latency of 500 ms. It sets only the connection; the phone’s camera and encoder stay as they are. Scanning it again replaces that connection rather than adding a second.
Another app takes the addresses, with Copy.
Over the internet
A phone on mobile data, or an encoder anywhere, can send to InterDirector over the internet, through a relay server of ours. Neither the phone nor this Mac needs an open port or a public address.
- Press Add Input…, choose Network Stream, and set Comes in to Over the Internet. (An input you already have: the same, in its settings.)
- Choose the Region closest to the phone and to you, and press Get an Address. This makes the input’s own address. It starts nothing yet.
- Scan the QR code with the phone to set InterDirector Cam or Larix up (see above), or copy the SRT address, Stream ID and Passphrase into another app. An app without SRT can use the RTMP address, which is not encrypted.
- Press Start Server to start the server there now (about a minute), then Add: the input is added running, and its card says Waiting for a sender until the phone sends. Or press Add alone, and Start on the card, or Start Server in the input’s settings, when you want to receive.
The address is saved with your Show and stays the same, so a phone set up the day before still sends to it. New Address… makes another; the phone then has to be set up again.
A few things to know:
- Nothing starts by itself. An input over the internet starts only when you press Start, never when the Show opens, and its card reads Ready until then.
- A session lasts 24 hours. After that the card waits for you to start it again, at the same address.
- Six addresses, in one region. A licence can hold up to six addresses, all in one region, and receive on all six at once. Only the licence’s region is offered once it has an address, and Get an Address is not offered once it has six. Removing an input over the internet, in any Show, frees its address. An address left in a Show closed without saving still counts: Release Addresses No Open Show Uses… lets go every address no Show open on this Mac uses, except one receiving right now. Inputs in Shows that are not open then need a new address.
- Stop All Relays and Free the Server… stops every stream the licence receives over the internet, on this Mac and any other with the licence, and shuts its relay server down at once, rather than 15 minutes after the last stream stops. Addresses are kept, so the phones keep their settings; each input starts again with Start, on a new server.
- Removing the input releases its address, so a phone set up for it cannot send into anything again.
- Latency. The relay adds the network’s own delay twice, phone to server and server to Mac. Over mobile data, expect a picture about two seconds behind the camera; hold your other sources back with their Input delay, which goes up to four seconds.
Its address is saved with your Show, logins included. Anyone with the Show file can send to it while it runs. The relay passes the stream on and records nothing of it.
Its sound, or another input’s
A phone or an encoder’s own microphone is often not the sound you want, or not all of it. On the input’s Audio tab, under Audio Source, tick what it is heard with: Its own sound (ticked to begin with), other inputs’ sound (a microphone on an Audio input, say), or several. With nothing ticked it has no sound and no mixer strip at all. See Pairing an input’s sound.
What a stream can carry
H.264 or HEVC pictures, decoded by your Mac’s hardware, and AAC sound, or uncompressed PCM over SRT. Mono sound is heard on both sides; a stream with more than two channels gives its first two.
A stream of sound alone works too, such as a track from a DAW sent over SRT by our InterStream plug-in, in AAC or uncompressed PCM.
Next
- Recording inputs, to keep each armed source in a file of its own.
- A source that keeps reconnecting.