# Lyra

Self-hosted, multi-source music acquisition and library tool — a replacement for
Lidarr + NZBget. Lyra discovers, ranks, downloads, tags, and organizes music across
sources of differing quality: **Qobuz** (lossless/hi-res), **Soulseek** (P2P),
**YouTube** (universal lossy fallback), and **Spotify** (discovery/metadata only).

## Status

Early design. Built in three slices:

1. **Acquisition engine** — *in progress*. Given an album/track, find the best
   available source, download it, tag it against MusicBrainz, and file it into a
   clean library.
2. **Library manager** — Lidarr-style monitoring, wanted lists, auto-grab of new
   releases.
3. **Discovery** — Spotify/recommendation-driven finding of new music.

## Architecture

Three Docker containers on a home server:

- **Next.js app** — UI + API (search, request, queue, progress, settings).
- **Python worker** — all source integration (streamrip, yt-dlp, slskd client,
  beets/mutagen), running the six-stage acquisition pipeline.
- **slskd** — off-the-shelf headless Soulseek daemon.

**Postgres** is the shared source of truth; a shared `/music` volume is the library.

See [`docs/superpowers/specs/`](docs/superpowers/specs/) for the full design.