ian/zoitestream
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update connection instructions

Browse source
This commit is contained in:
Ian Keane 2026-09-16 10:03:58 -04:00
parent 6aa9bf85f3
commit 0eabd5c1de
1 changed files with 27 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

32
app/templates/index.html
View file

@ -78,15 +78,37 @@
<p>Streaming credentials are shared via IRC — ask there for the current <p>Streaming credentials are shared via IRC — ask there for the current
publish URL/password. This is a single shared stream: whoever is publish URL/password. This is a single shared stream: whoever is
currently publishing is what everyone sees.</p> currently publishing is what everyone sees.</p>
<p><strong>OBS Studio</strong> 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.</p>
<h3>Option A: OBS Studio</h3>
<ol> <ol>
<li>Open <strong>OBS Studio</strong> (or use ffmpeg directly).</li> <li>Open OBS, go to <em>Settings &rarr; Stream</em>, set Service to
<li>In OBS, go to <em>Settings &rarr; Stream</em>, set Service to
<strong>Custom...</strong>, and paste the full URL you were given <strong>Custom...</strong>, and paste the full URL you were given
into the <strong>Server</strong> field, leaving Stream Key empty.</li> into the <strong>Server</strong> field, leaving Stream Key empty.</li>
<li>Or with ffmpeg: <code>ffmpeg -re -i input -c:v libx264 -c:a aac -f flv "&lt;url you were given&gt;"</code> <li>Add your capture sources (screen/window/game capture + audio) as
(audio must be AAC and video H.264 — RTMP/FLV doesn't support other codecs)</li> normal, then click <strong>Start Streaming</strong>.</li>
<li>Click <strong>Start Streaming</strong>.</li>
</ol> </ol>
<h3>Option B: ffmpeg one-liner (Linux, X11)</h3>
<p>If you're on X11 (or a Wayland session with Xwayland exposing
<code>:0.0</code>), this captures your screen + default audio
directly, no extra tools needed:</p>
<pre>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 "&lt;url you were given&gt;"</pre>
<p>Swap <code>-preset veryfast</code> for <code>ultrafast</code> on
weaker machines, or <code>fast</code>/<code>medium</code> if you
have CPU to spare. RTMP/FLV requires H.264 video and AAC audio —
other codecs won't work here.</p>
<h3>Option C: ffmpeg with a file/other source</h3>
<p>For rebroadcasting a pre-recorded file or another running stream
instead of capturing your screen:</p>
<pre>ffmpeg -re -i input -c:v libx264 -c:a aac -f flv "&lt;url you were given&gt;"</pre>
<p>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.</p>
</section>
<h2>How to watch</h2> <h2>How to watch</h2>
<p>Open this URL in your browser:</p> <p>Open this URL in your browser:</p>
<pre>https://{{ domain }}/&lt;path&gt;</pre> <pre>https://{{ domain }}/&lt;path&gt;</pre>