-
Notifications
You must be signed in to change notification settings - Fork 17
Quick Start
From zero to a live stream in a couple of minutes. If you haven't installed yet, see Installation.
./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.
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 |
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.
| 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.
- 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.
Getting started
Streaming
Integrations
Operations
Internals
Help