Broadcast Protocol

NitroShare uses IPv4 broadcast to send UDP packets to other devices on the local network. These packets include connection information, allowing the other devices to initiate transfers.

By default, all UDP packets are broadcast on port 40816 of every active network interface with an IPv4 broadcast address. Each packet is a JSON encoded object that resembles the following:

{
    "uuid": "{9709d588-c1d0-4258-b55f-cc4eaea120e7}",
    "name": "MyMachine",
    "operating_system": "windows",
    "port": "40818",
    "uses_tls": false
}

Each field is described in detail:

• uuid - this is the unique identifier for the device - it should not change
• name - the name assigned to the device by the user
• operating_system - one of the following (custom values can be used, however, clients will then display the operating system as "Unknown"):
  • windows
  • osx
  • linux
  • android
• port - TCP port the device is using to listen for incoming transfers (note that this is a string, even though it contains a numeric value)
• uses_tls (optional) - true if the device requires transfers to use TLS encryption