Jarian Cottingham
24c03426f8
- Add pytest config with 90% coverage threshold - 15 test files covering all routers, services, schemas, models - 300 tests: unit tests, integration tests, edge cases, mocked external APIs - Update CI workflow to run pytest with coverage enforcement - Mock external services (Genius, MusicBrainz, RadioBrowser) - In-memory SQLite DB per test via conftest fixtures
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
- Debian/Ubuntu:
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 filesDATABASE_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