Installation Overview

Shiloh Broadcaster is split into four components. Each runs on a different machine — install only what that machine needs.

Components at a glance

Component Machine OS Key requirements
shiloh-mixer Hub/server Linux JACK (jackd or pipewire-jack), Rust toolchain
shiloh-broadcaster Studio laptop or desktop Linux PipeWire (pipewire-pulse shim), JACK client libraries, Rust toolchain
shiloh-relay Listener (Pi, laptop, desktop) Linux / Windows / aarch64 Audio output device (ALSA or PipeWire)
shiloh-web-relay Hub/server (same host as mixer) Linux Rust toolchain, outbound UDP to mixer
mixer_web Hub/server (same host as mixer) Linux Elixir ≥ 1.15, Phoenix

Quick orientation

Studio laptop                      Hub server (e.g. stg-srv001)
─────────────────                  ──────────────────────────────────────
shiloh-broadcaster  ──UDP 5005──▶  shiloh-mixer  ◀──JACK──  hardware inputs
                                        │
                              UDP 5005 fan-out
                                   ├──────────────────────▶  shiloh-relay (Pi)
                                   ├──────────────────────▶  shiloh-relay (desktop)
                                   └──▶ shiloh-web-relay  ──WHEP──▶  browsers
                                              :8890
                                   mixer_web  ──control 19997──▶  shiloh-mixer
                                        :8889  (LiveView UI)

Sub-pages

Typical install order

  1. Build all binaries on the hub server (cargo build --release).
  2. Install and start shiloh-mixer first — everything else depends on it.
  3. Install mixer_web so you have a UI before connecting sources.
  4. Install shiloh-web-relay if you need browser listeners.
  5. On each studio machine, install shiloh-broadcaster.
  6. On each listening device, install shiloh-relay.