From 0eabd5c1de4cf1fb97aea0674efeac9bca6bf6fb Mon Sep 17 00:00:00 2001 From: Ian Keane Date: Wed, 16 Sep 2026 10:03:58 -0400 Subject: [PATCH] Update connection instructions --- app/templates/index.html | 32 +++++++++++++++++++++++++++----- 1 file changed, 27 insertions(+), 5 deletions(-) diff --git a/app/templates/index.html b/app/templates/index.html index b8181f4..decec7d 100644 --- a/app/templates/index.html +++ b/app/templates/index.html @@ -78,15 +78,37 @@

Streaming credentials are shared via IRC — ask there for the current publish URL/password. This is a single shared stream: whoever is currently publishing is what everyone sees.

+

OBS Studio works great on any OS (Linux/X11, + Wayland, macOS, Windows) and is the easiest option for most people — + screen/window capture, audio mixing, and encoder settings are all + handled in the UI. If you'd rather use a terminal-only workflow, + ffmpeg one-liners are also available below depending on your setup.

+

Option A: OBS Studio

    -
  1. Open OBS Studio (or use ffmpeg directly).
    2. -
  2. In OBS, go to Settings → Stream, set Service to +
  3. Open OBS, go to Settings → Stream, set Service to Custom..., and paste the full URL you were given into the Server field, leaving Stream Key empty.
    4. -
  4. Or with ffmpeg: ffmpeg -re -i input -c:v libx264 -c:a aac -f flv "<url you were given>" - (audio must be AAC and video H.264 — RTMP/FLV doesn't support other codecs)
    5. -
  5. Click Start Streaming.
    6. +
  6. Add your capture sources (screen/window/game capture + audio) as + normal, then click Start Streaming.
+

Option B: ffmpeg one-liner (Linux, X11)

+

If you're on X11 (or a Wayland session with Xwayland exposing + :0.0), this captures your screen + default audio + directly, no extra tools needed:

+ 
ffmpeg -f x11grab -framerate 30 -i :0.0 -f pulse -i default -c:v libx264 -preset veryfast -tune zerolatency -pix_fmt yuv420p -c:a aac -b:a 128k -f flv "<url you were given>"
+

Swap -preset veryfast for ultrafast on + weaker machines, or fast/medium if you + have CPU to spare. RTMP/FLV requires H.264 video and AAC audio — + other codecs won't work here.

+

Option C: ffmpeg with a file/other source

+

For rebroadcasting a pre-recorded file or another running stream + instead of capturing your screen:

+ 
ffmpeg -re -i input -c:v libx264 -c:a aac -f flv "<url you were given>"
+

On Wayland (non-X11) screen capture generally needs a portal/PipeWire + flow rather than a single ffmpeg command — OBS handles this + transparently across compositors, which is why it's the recommended + option there.

+

How to watch

Open this URL in your browser:

https://{{ domain }}/<path>