NDI Stream Discovery
- Elisa Diel (Unlicensed)
Analytics
NDI uses the mDNS (Bonjour / Zeroconf) discovery mechanism to create a zero-configuration environment for discovery of NDI streams available on the LAN. Through mDNS, devices such as the Zixi Broadcaster can discover available NDI streams for processing. The mDNS (Bonjour / Zeroconf) discovery mechanism should be installed as required according to the system's OS, as described in the OS Support section.
This means that there are different requirements depending on the type deployment:
Using NDI within a local area network – on a local area network NDI will use the discovery mechanism to advertise the sources and Zixi Broadcaster will automatically discover these streams, while listing them in the Stream parameter of the NDI input stream.
Using NDI in the cloud – to make the streams discoverable in the cloud, you need to deploy an NDI Discovery Server and configure the NDI plug-in with the settings included in the following example:
{
"ndi": {
"groups": {
"recv": "\"public\"",
"send": "\"public\""
},
"multicast": {
"recv": {
"enable": false,
"subnets": ""
},
"send": {
"enable": false,
"netmask": "255.255.255.0",
"netprefix": "239.192.136.100"
}
},
"networks": {
"discovery": "22.127.94.57",
"ips": ""
},
"tcp": {
"recv": {
"enable": false
},
"send": {
"enable": false
}
},
"unicast": {
"recv": {
"enable": false
},
"send": {
"enable": false
}
}
}
}
OS Support
The use of mDNS requires operating system support as follows:
Windows - Windows 10 has mDNS support built in, which is necessary for any NDI applications running on Windows.
CentOS 7 - The recommended platform for the Zixi Broadcaster is CentOS 7. mDNS support is provided by the Avahi package which typically is not installed by default on CentOS 7.
To install Avahi, run the following commands on the server hosting the Zixi Broadcaster:
# sudo yum install avahi
# sudo service avahi-daemon start
Enabling Multicast Network Support
The mDNS Ethernet frame is a multicast UDP packet that broadcasts to:
MAC address 01:00:5E:00:00:FB(for IPv4)
IPv4 address 224.0.0.251
UDP port 5353
You need to verify that the LAN where NDI streams are present is multicast enabled and that all systems needing access to NDI streams, such as the Zixi Broadcaster, do not block mDNS via their firewall.
NDI config file location
On Windows: %PROGRAMDATA%\NewTek\NDI\ndi-config.v1.json
On Linux: $HOME/.newtek/ndi-config.v1.json
On Linux the NDI config files should be placed in the home directory of the user which Broadcaster is running as root. Thus, the file must be located at /root/.newtek/ndi-config.v1.json
Specifying the NDI Discovery Server
To specify NDI Discovery Server:
Open ndi-config.v1.json.
In the "networks" section, under "discovery" add the discovery server’s IP, which is the address of a host where NDI Discovery Server is working.
For example, if you have it working on 192.168.0.253, then your config will have this section:"networks": {"ips": "","discovery": "192.168.0.253"},