Drift FM

Mood radio you host yourself.

Drop in your mp3s, tag them by mood, hit play. Continuous shuffled playback per mood. No accounts, no tracking, no frameworks.

Go SQLite Vanilla JS

Quick Start

git clone https://github.com/1mb-dev/driftfm.git && cd driftfm
make db-init && make import-batch ARGS="/path/to/music"
make run
# → http://localhost:8080

Documentation

Quickstart — Step-by-step setup with your own music library. Prerequisites, import, configuration, troubleshooting.

Architecture — System internals. Backend packages, data model, frontend structure, request flow.

Building Drift FM — Why these choices. The philosophy behind Go + SQLite + vanilla JS, shuffle with memory, and the .txt convention.

Design Language — Frontend design system. Color tokens, theming, glass morphism, motion, responsive patterns, accessibility.

Links

• GitHub
• Issues
• Contributing
• License (MIT)