TinyWebRadio: Open-Source Tools and Tips for Tiny Streaming Servers

TinyWebRadio: A Beginner’s Guide to Building a Minimal Internet Radio

What it is

TinyWebRadio is a small, self-hosted internet radio project focused on streaming audio with minimal hardware and software overhead—ideal for hobbyists using devices like a Raspberry Pi or other single-board computers.

Who it’s for

• Beginners learning audio streaming and networking
• Makers wanting a low-power, always-on music player
• Educators demonstrating streaming concepts

Key components

• Hardware: Raspberry Pi (Zero/3/4) or similar, USB audio adapter or DAC, speakers, microSD card, optional small display.
• Software: Lightweight web server (e.g., Nginx, Caddy), audio streamer (Icecast, Darkice, or simple HTTP streaming with ffmpeg), player UI (minimal HTML/JS), system service (systemd) for auto-start.
• Network: LAN access or port-forwarding/NGROK for remote streaming.

Minimal build outline (presumes Raspberry Pi and Linux)

1. Prepare OS: Flash Raspberry Pi OS Lite to microSD and enable SSH.
2. Install audio tools: Install ffmpeg (or darkice) and an Icecast server (optional if using direct HTTP streams).
3. Set up web server: Install Nginx to serve a tiny web UI and proxy stream endpoints.
4. Create stream: Use ffmpeg to capture local audio files or an input device and serve via HTTP or push to Icecast. Example command to stream a folder of MP3s over HTTP:
   ffmpeg -re -stream_loop -1 -i playlist.mp3 -c copy -f mp3 icecast://source:password@localhost:8000/tinyradio

5. Build UI: Minimal HTML page with an tag pointing to the stream URL and simple play/pause controls.
6. Auto-start: Create a systemd service to run the streamer on boot.
7. Test & secure: Verify stream locally, set appropriate firewall rules, and use a reverse proxy with HTTPS if exposing remotely.

Features to add later

• Playlists and scheduling
• Web-based upload management for new tracks
• Metadata (track title/artist) via Icecast or ICY headers
• Small LCD display showing currently playing track
• Authentication or token access for private streams

Troubleshooting tips

• No audio: check ALSA device configuration and volume (alsamixer).
• Buffering: increase ffmpeg buffer sizes or tune Icecast mount settings.
• Metadata not updating: ensure encoder sends ICY metadata or use Icecast with updated source client.

Resources to consult

• Icecast and Darkice docs for server/source setup
• ffmpeg streaming examples for different input types
• Nginx reverse proxy and HTTPS (Let’s Encrypt) guides

If you want, I can generate: a ready-to-run script (installation + systemd service), a minimal HTML player page, or tailored instructions for a specific Raspberry Pi model—tell me which.