init liquidsoap. We thank our uncle Claude, gave him 1.74$ so he can buy a beer. He got drunk on wine and we had to clean the mess ourselves. Sacré oncle Claude !

README.md

@@ -1,3 +1,30 @@
 # radio-bullshit
 
-Radio Bullshit
+Radio Bullshit - Internet radio streaming powered by Liquidsoap
+
+## Features
+
+- Automatic song/jingle alternation (1 jingle per 4 songs)
+- YouTube playlist sync with yt-dlp
+- Built-in HTTP streaming server (no Icecast needed!)
+- Fallback "air support" audio for resilience
+- Modern, open-source stack (Liquidsoap + Python)
+
+## Quick Start
+
+```bash
+docker build . -t radio-bullshit && \
+  docker run -it --rm -p 8000:8000 \
+  -v `pwd`/jingles:/jingles \
+  -v `pwd`/songs:/songs \
+  radio-bullshit
+```
+
+Then visit http://localhost:8000 to listen!
+
+## Stack
+
+- **Liquidsoap** - Audio stream generation and HTTP server
+- **yt-dlp** - YouTube playlist downloading
+- **FFmpeg** - Audio format conversion
+- **Python 3.9** - Automation scripts