RISTTUNNEL(1)

📦 version 0.2.20, in ubuntu stonking

💖 RISTTUNNEL(1) 💖

okay bestie, sit down, hydrate, because we're about to talk about risttunnel — a User Commands girlie through and through, and yes she is that manual page. IP tunnel over RIST, with ARQ packet recovery, and she ate. 🎀

🌸 NAME 🌸

risttunnel — an IP tunnel over RIST with ARQ packet recovery. that's the whole vibe. tunneling, but with packet recovery, so the packets that ghosted get dragged back. 🦋

✨ SYNOPSIS ✨

risttunnel [OPTIONS]

literally just that. no subcommands, no drama. options only. periodt. 💅

🫶 DESCRIPTION 🫶

okay so. Reliable Internet Stream Transport (RIST) is a transport protocol designed for reliable transmission of video over lossy networks (including the Internet) with low latency and high quality. emphasis on lossy because the internet is a mess and RIST simply refuses to be messy back.

and risttunnel? risttunnel allows one to tunnel over RIST with ARQ packet recovery. that's it, that's the function. it's giving "I put a tunnel inside the transport" and honestly, iconic. 🔥

🎀 Where OPTIONS are:

  • -l, --local-ip IP/PREFIX — Mandatory Option: the local tunnel IP. think 10.0.0.1/24 or fd00::1/64. you cannot skip this one, bestie, she's required. 💖
  • -o, --output-url URL — Mandatory Option: the RIST URL for sending. where the packets go out the door. 🚪✨
  • -b, --input-url URL — Mandatory Option: the RIST URL for receiving. where the packets come in and sit down. 🛋️
  • -i, --interface NAME — TUN interface name. default is auto, so she picks for herself. main character energy. 👑
  • -m, --mtu INT — TUN MTU. default: 1400. respect the number. 📏
  • -M, --rtt-multiplier INT — RIST buffer RTT multiplier. default: 3. it multiplies the RTT, that's the whole job. ✖️
  • -s, --secret STRING — PSK shared secret. whisper it. 🤫
  • -e, --encryption-type INT — AES type: 128 or 256. default: 128. 🔐
  • -S, --statsinterval INT — stats interval in ms. default: 1000, and 0 means off (stats girlies, this is your moment). 📊
  • -v, --verbose-level INT — log level 0-6. default: 3. crank it if you want the tea. 🍵
  • -1, --single-port — one UDP port, where forward = RTP/ARQ and reverse = OOB. and listen: give exactly one of -o (caller) or -b (listener). exactly one. not both. we don't do both here. 🚫
  • -p, --profile INT — RIST profile: 0 = simple, 1 = main, 2 = advanced. default: 2. she's advanced by default, obviously. 💅
  • -F, --srpfile PATH — EAP-SRP verifier file (server side). server girls, this one's for you. 🖥️
  • -h, --help — show this help. the classic. the icon. 🆘

🧚 Example (server / listener side):

sudo /usr/bin/risttunnel -l 10.0.0.1/24 -b rist://@:5000 -o rist://@:5001

🌈 Example (client / caller side):

sudo /usr/bin/risttunnel -l 10.0.0.2/24 -b rist://server:5001 -o rist://server:5000

🍓 Usage: append to end of individual rist:// url(s) as

?param1=value1&param2=value2...

💜 Simple, Main and Advanced Profiles

  • param buffer=### — buffer size in milliseconds. ⏱️
  • param buffer-min=### — min buffer size in milliseconds
  • param buffer-max=### — max buffer size in milliseconds
  • param bandwidth=### — max bandwidth in Kbps
  • param return-bandwidth=### — max bandwidth for messaging return in Kbps
  • param reorder-buffer=### — reordering buffer size in ms
  • param cname=abcde — arbitrary name for stream for display in logging
  • param rtt-min=### — minimum expected rtt
  • param rtt-max=### — maximum expected rtt
  • param timing-mode=# — 0 = RTP Timestamp (default); 1 = Arrival Time, 2 = RTP/RTCP Timestamp+NTP

👑 Main and Advanced Profiles

  • param aes-type=# — 128 = AES-128, 256 = AES-256 must have passphrase too
  • param secret=abcde — encryption passphrase
  • param virt-dst-port — destination port inside the GRE header
  • param session-timeout=### — timeout in ms for closing of connection where keep-alive fails
  • param keepalive-interval=### — interval in ms
  • param key-rotation=## — number of IP packets before a key rotation is triggered
  • param congestion-control=# — mitigation mode: (0=disabled, 1=normal, 2=aggressive)
  • param min-retries=## — min retries count before congestion control kicks in
  • param max-retries=## — max retries count
  • param weight=# — default weight for multi-path load balancing. Use 0 for duplicate paths.
  • param username=abcde — Username to identify this peer during authentication
  • param password=abcde — Password corresponding to this peer's Username

⭐ Advanced Profile

  • param compression=1|0 — enable lz4 levels

🦋 Usage: append to end of individual udp:// or rtp:// url(s) as

?param1=value1&param2=value2...
  • param miface=(device) — device name (e.g. eth0) for multicast
  • param stream-id=# — ID number (arbitrary) for multiplex/demultiplexing steam in peer connector
  • param multiplex-mode=# — Controls how rist payload is muxed/demuxed (-1=auto-detect, 0=rist/raw, 1=vrt_src_port, 2=ipv4)

🔍 SEE ALSO 🔍

ristsender(1), ristreceiver(1), https://code.videolan.org/rist/librist/-/wikis/LibRIST%20Documentation

go read your sisters, they're also slaying. 💖

💌 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. 🫶

ok that's the whole page bestie, every flag, every param, every default, all of it, nothing skipped, nothing invented. slay responsibly. 🌸

and for the little footnote moment: this is risttunnel 2 / libRIST 0.2.13 A... dated April 2026 — so yeah, future-dated, iconic, ahead of her time, as always. 💅✨

📦 where this page comes from