Reference

Technical reference

The essentials for wiring SenderoGo into your own setup. Full documentation is being written during the beta — if something you need is missing, tell us.

Protocols & URLs

SenderoGo Mobile publishes over SRT (caller mode) or RTMP. Target URLs look like:

srt://<host>:<port>?streamid=<name>
rtmp://<host>/<app>/<stream-key>

Notes:

  • SRT passphrases must be 10–79 characters (a protocol rule). SenderoGo Receiver requires one — it refuses to listen without it.
  • The streamid names the publisher; the receiver uses it to label previews and recording files, and (in allowlist mode) to select the per-publisher passphrase.
  • Streaming to third-party endpoints (OBS, MediaMTX, YouTube, Twitch) follows that service's URL format; SenderoGo adds nothing proprietary.

Receiver basics

SenderoGo Receiver (macOS) listens on a port you choose, previews incoming streams, and records them to your chosen folder.

  • Authentication — one shared passphrase for all publishers, or an allowlist mode where each streamid has its own passphrase and unlisted publishers are refused. Entries are individually revocable.
  • Recording — streams are written to disk as they arrive and finalized to standard MP4 on stop. If the app is interrupted mid-recording, the finished portion is recovered on the next launch.
  • Forwarding — rules can relay an incoming stream to another SRT destination while it records.
  • Disk safety — the receiver refuses to start recording without breathing room, stops cleanly if space runs low, and can reclaim space from old failed recordings.

Linux CLI (sdgo)

The Linux receiver is a single binary driven by subcommands:

sdgo setup       # interactive first-time configuration
sdgo listen      # run the receive hub (records incoming streams)
sdgo ls          # list recordings
sdgo rm          # delete recordings
sdgo version     # print the installed version
  • Configuration lives at ~/.config/senderogo/config.json, created with owner-only permissions because it holds the SRT passphrase.
  • Recordings default to ~/senderogo-recordings (configurable in setup).
  • By default only local-network publishers may connect; the access scope can be widened deliberately (e.g. for Tailscale, allow its address range in setup).
  • Installed via the apt repository, sdgo updates with normal apt upgrade.