RIST2RIST(1)

📦
version 0.2.20 · 2 versions
, in ubuntu stonking

💖 RIST2RIST — tunnel a RIST connection between two URIs 💖

okay bestie, sit DOWN, because this one is a whole vibe. this is rist2rist, a User Command, and it is exactly what it says on the tin: it tunnels a RIST stream between two URIs. one in, one out, slay. 🎀

🌸 SYNOPSIS 🌸

rist2rist [OPTIONS]

that's it. that's the whole thing. no positional args, no drama, just options. periodt. ✨

🦋 DESCRIPTION 🦋

Reliable Internet Stream Transport — RIST for short, iykyk — is a transport protocol built for shipping video reliably over lossy networks (yes, including the whole entire Internet 🌍), with low latency and high quality. it's giving trustworthy. it's giving main character transport layer.

and rist2rist? rist2rist lets you tunnel a RIST stream between two URIs. that's the job. it does the job. 💅

✨ Where OPTIONS are: ✨

(the original really said "Where OPTIONS are" and honestly? iconic phrasing, we're keeping it)

  • -i, --inurl ADDRESS:PORT — Mandatory Option 🚨 bestie this is not optional, this is the input IP address and port. no input, no stream, no nothing.
  • -o, --outurl ADDRESS:PORT — Mandatory Option 🚨 the output IP address and port. also not optional. the tunnel needs somewhere to go, obviously.
  • -s, --secret PWD — your pre-shared encryption secret. shhh. 🤫
  • -e, --encryption-type TYPE — which encryption flavor we're rocking: 0 = none, 1 = AES-128, 2 = AES-256. pick your fighter.
  • -S, --statsinterval value (ms) — how often the stats get printed, in ms. set it to 0 to disable entirely. quiet mode activated. 🙈
  • -N, --cname identifier — a manually configured identifier. you name it, it is it.
  • -v, --verbose-level value — set it to -1 to disable logging completely, and otherwise the log levels match syslog levels. very demure, very syslog. 😌
  • -r, --remote-logging IP:PORT — yeets your logs and stats over to this IP:PORT as udp messages. remote logging era. 📡
  • -p, --profile number — the RIST receive profile: 0 = simple, 1 = main, 2 = advanced. glow up from simple to advanced, fr fr.
  • -n, --npd — enable Null Packet Deletion on output. delete the nulls, they were doing nothing anyway. 💀
  • -F, --srpfile filepath — when you're in listening mode, this file holds the list of usernames and passwords to validate against. and bestie, use the ristsrppasswd tool to create the line entries, don't hand-type them, trust. 🫶
  • -M, --enable-metrics — turn on OpenMetrics/Prometheus compatible metrics. numbers! graphs! obsession! 📈
  • --metrics-tags — extra tags to add to the metrics. accessorize. 🎀
  • --metrics-http — start an HTTP Server to expose the metrics. put them on display, they deserve it.
  • --metrics-port — the port for the metrics HTTP server (default: 9100).
  • --metrics-ip — the IP for the metrics HTTP server (default: 0.0.0.0).
  • -h, --help — show this help. hi, this is help. 👋
  • -u, --help-url — show all the possible url options. the full menu, the extended cut, the director's version. 🌈

💫 Default values: 💫

because defaults are the friend you didn't know you had:

  • --profile 0
  • --statsinterval 1000
  • --verbose-level 6

⭐ SEE ALSO ⭐

go read these next, bestie, they're all in the family:

👑 AUTHOR 👑

This manual page was written by Florian Ernst <florian@debian.org>, for the Debian project (and may be used by others). absolute legend behavior, no cap. 🫡

okay but real talk — the mandatory options are MANDATORY. if you skip -i or -o nothing is tunneling and you'll be sitting there like 🙈 wondering why. don't do that to yourself.

and that's the whole page!! this was rist2rist version: 30, libRIST l..., from April 2026 — mwah, kisses, go tunnel something cute 💖✨🎀🦋

📦 where this page comes from