Tunecamp
Static site generator & streaming server for musicians
npx tunecamp init my-catalog
to get started
Built for independence
- 🎵 Audio-first
- 🚀 Static & fast
- 🌐 Host anywhere
- 💾 No database (static mode)
- 🔒 Privacy-friendly
- 📱 Fully responsive
- 🖥️ Server mode available
- 🔐 Type-safe (Gleam)
Streaming
Built-in audio player with playlist support. Visitors can listen directly on your site.
Downloads
Free, pay-what-you-want, or unlock codes. You control how your music is distributed.
RSS & Atom
Auto-generated feeds let fans subscribe to your releases.
Playlists
M3U playlists for desktop players and streaming apps.
Analytics
Optional decentralized download stats via GunDB. No tracking cookies.
Themeable
Customize colors and images. Works in dark and light modes.
Server Mode
Personal streaming server with REST API, web interface, and advanced library management.
Comments
Decentralized comments system on tracks using GunDB. No central server required.
Statistics
Track listening habits, play history, and top tracks/artists in Server Mode.
Waveforms
Visual waveform generation for audio files in Server Mode.
Lyrics
Display and manage lyrics for tracks in Server Mode.
Search
Full-text search across tracks, albums, and artists in Server Mode.
📥 Distribution Options
- Free — Immediate download without restrictions
- Pay-what-you-want — Suggest a price with honor system
- Unlock codes — Protect downloads with unique codes
- Streaming only — No downloads, just playback
🖥️ Server Mode
Tunecamp includes a powerful personal streaming server for managing and streaming your music library.
- Web Interface — Browse and stream your library via modern web UI
- Advanced Player — Full-featured player with scrubbing, queue, lyrics, and volume control
- REST API — Complete API for tracks, albums, artists, playlists, comments, and more
- Library Management — Dual modes (Release & Library), smart scanning, file browser
- Uploads — Web-based upload for tracks, covers, and avatars
- Statistics — Track listening habits, play history, top tracks/artists
- Comments — Decentralized comments on tracks via GunDB
- Network Discovery — Browse and play tracks from other TuneCamp instances
- Waveform Generation — Visual waveform data for audio files
- User Authentication — Decentralized user accounts for comments and profiles
tunecamp server ./music --port 1970
🌐 Community Directory
Tunecamp sites can auto-register to a public directory. Discover other artists and share your music with the community.
- Decentralized — Powered by GunDB peer-to-peer network
- Real-time — New sites appear instantly
- Privacy-first — Only public info shared (URL, title, artist name)
- Network Discovery — In Server Mode, browse and play tracks from other instances
⚡ Quick Start
Install globally
npm install -g tunecamp
Create your site
tunecamp init my-catalog
Or build from existing catalog
tunecamp build ./my-catalog -o ./public
Start Server Mode
tunecamp server ./music --port 1970
See the README for full documentation.
Sites using Tunecamp
Want to add your site? Open a PR on GitHub