HiFi Music Streaming Platform

A self-hosted, privacy-respecting music streaming web app with lossless/hifi playback, designed for TrueNAS Scale.

Features

• Native FLAC, WAV, MP3, AAC, and DSD support
• On-the-fly transcoding for web playback
• Multi-user authentication with role-based access
• Playlists, favorites, and smart playlist support
• Lyrics support (embedded, sidecar LRC)
• Multiple UI themes (Spotify, Qobuz, Apple Music-inspired)
• Web Audio API visualizer
• Privacy-respecting, ad-free, no telemetry

Architecture

See ARCHITECTURE.md for complete design documentation.

Quick Start

# Using Docker Compose
docker-compose up -d

# Or using Kubernetes (TrueNAS Scale)
helm install hifitrack ./helm-chart

Development

# Backend
cd backend
composer install
php artisan serve

# Frontend
cd frontend
npm install
npm run dev

License

MIT License