User-facing references and per-feature deep dives. The top-level README keeps the install / quick-start path short — anything substantive about how a feature actually works lives here.
| Doc | Scope |
|---|---|
| Playback engine | Decoder pipeline, crossfade DSP, ReplayGain, output device selection, OS media controls, persistent queue, A-B repeat |
| Library | Folder scanning + management (add / watch / remove), filesystem watcher, drag-and-drop import, duplicate detection, on-demand audio analysis, multi-artist split, ratings, A-Z navigator |
| Playlists | User playlists CRUD, M3U import/export, likes, recently-played |
| Smart playlists | Daily Mix auto-generation + user-defined rule editor: algorithm, cover compositor, regen flow |
| Integrations | Deezer / Last.fm / LRCLIB clients, metadata cache, scrobble worker, similar-artists discovery, in-app lyrics editor |
| DLNA / UPnP server | Built-in MediaServer: SSDP discovery, ContentDirectory Browse, Range streaming to LAN amplifiers |
| UI & UX | Layout, panels, mini-player widget, tray, statistics, dark mode, i18n, profiles, onboarding, auto-updater |
| Doc | Scope |
|---|---|
| Audio architecture | 3-thread lock-free pipeline, ring buffer sizing, callback constraints |
| Database & paths | app.db vs per-profile data.db, on-disk layout, migration policy |
CONTRIBUTING.md and RELEASING.md cover the contribution and release flows respectively. Anything project-wide that should always be loaded into Claude Code's context lives in CLAUDE.md at the repo root.