# SamCloud Music (SpotSpot Unified)

A unified, Apple Music-style music app with real-time search, download, progress, notifications, Navidrome browsing, and Finamp integration. Powered by a single Python backend (Flask + SocketIO) and modern frontend, all running in one container.

## Features
- Spotify search and YouTube download (SpotDL)
- Real-time progress and notifications
- Apple Music-style UI (tabs: Search, Browse, Downloads)
- Navidrome library browsing
- Finamp player integration
- Single-container, single-origin deployment

## Quick Start
1. `cd app`
2. `pip install -r requirements.txt`
3. `python spotspot.py`

Or use Docker (recommended):

    docker build -t samcloud-music .
    docker run -p 5000:5000 samcloud-music

## Configuration
- Place your Spotify API keys and config in `app/services/config_service.py` (to be created).
- Static assets in `app/static/`, templates in `app/templates/`.

## License
MIT