Quick Start

Quick Start

From zero to a live stream in a couple of minutes. If you haven't installed yet, see Installation.

1. Run it

./tinyice

On the first run TinyIce generates secure credentials and prints them once:

FIRST RUN: SECURE CREDENTIALS GENERATED
  Admin Password:           Oy9…
  Default Source Password:  Rm3…
  Live Mount Password:      8fX…

Save these now — they are written to tinyice.json as bcrypt hashes and cannot be recovered from disk. (Running under systemd? They land in the journal: journalctl -u tinyice | grep -A4 "FIRST RUN".)

Open http://localhost:8000 for the public landing page, and http://localhost:8000/admin to log in with admin + the admin password.

2. Send a stream

Pick whichever source you have. Full details for each are in Streaming Sources.

Source	How
BUTT / Mixxx / LadioCast	Icecast 2 · server host:8000 · mount /live · user source · password = Live Mount Password
ffmpeg	ffmpeg -re -i input.mp3 -f mp3 -content_type audio/mpeg icecast://source:<pw>@host:8000/live
OBS (video)	Enable RTMP (below), then point OBS at rtmp://<host>/live with the mount password as the Stream Key. See Streaming Sources.
Browser mic	Admin → Go Live for WebRTC broadcasting straight from the browser
Files	Configure an AutoDJ pointed at a directory of audio files

Enable video ingest (optional)

RTMP and SRT are off by default. Turn them on in tinyice.json:

"ingest": { "rtmp_enabled": true, "rtmp_port": "1935", "srt_enabled": true, "srt_port": "9000" }

Restart, or ./tinyice reload to apply.

3. Listen / watch

Method	URL
Built-in player	http://localhost:8000/player/live
Direct audio (VLC, mpv, ffplay)	http://localhost:8000/live
HLS (audio or audio+video)	http://localhost:8000/live/playlist.m3u8
Playlist files	http://localhost:8000/live.m3u · .m3u8 · .pls
Embed on a web page	<iframe src="http://localhost:8000/embed/live" …>

The player automatically switches to a 16:9 video layout when the mount carries H.264. Click STATS in the player to see codec, resolution, fps, GOP, bitrate, dropped frames, buffer seconds, and live-edge latency.

4. Make it yours

• Branding — Admin → Settings → Branding: site name, tagline, accent colour, logo, and a Markdown landing page.
• HTTPS — flip on ACME and list your domains; see Deployment.
• Users — add admins/DJs, enrol passkeys, link OIDC; see Authentication and Users.
• Notifications — wire up Discord/Slack/Telegram on track changes; see Webhooks.

---

Next: Configuration for every setting, or jump to the feature you need from the sidebar.