Music App

Self-hosted music streaming application with mood radio, lofi channels, SharePlay, and internet radio.

Quick Start

docker-compose up --build

System Dependencies

• ffmpeg — required for audio transcoding (OGG conversion) and metadata extraction
  • Debian/Ubuntu: sudo apt-get install ffmpeg
  • macOS: brew install ffmpeg
  • Windows: download from https://ffmpeg.org/download.html

Configuration

Copy .env.example to .env and set your values:

cp .env.example .env

Key settings:

• API_KEY — API key for authentication (required in production)
• GENIUS_API_KEY — Genius.com API key for lyrics (get at https://genius.com/api)
• MUSIC_DIR — path to local music files
• DATABASE_URL — database connection string

Project Structure

• backend/ — FastAPI backend (Python)
• web/ — React web frontend (Vite + Tailwind)
• mobile/ — React Native mobile app (Expo)
• shared/ — Shared TypeScript types and API client
• e2e/ — Playwright end-to-end specs
• docs/ — Implementation plan

Tests

Backend (pytest, 90%+ coverage gate):

cd backend
pip install -r requirements.txt pytest-cov
pytest

300 tests covering endpoints, routers, services, schemas, and models.

E2E (Playwright):

npm install
npx playwright install
npm run dev:backend &   # start backend on :8000
npx playwright test

TypeScript (web + mobile + shared workspaces):

npm install
npm run typecheck
npm run lint

Development

npm workspaces scripts at the repo root:

npm run dev        # web + backend together
npm run dev:web    # Vite dev server only
npm run build:web  # production web build

License

MIT — see LICENSE.