minstrel/README.md

Minstrel

Self-hosted music server with OpenSubsonic compatibility plus an extended API for server-side smart shuffle, a dual-like model (general + contextual), session-aware radio, ListenBrainz scrobble/similarity, and Lidarr integration. Go + Postgres, packaged as a Docker container.

State and intelligence belong on the server, not the client.

Specs

Authoritative v1 scope lives under docs/:

• Server spec — current implementation focus.
• Client spec — Flutter companion app; work starts once the server reaches its Subsonic-compatible baseline.

Development workflow

• Day-to-day work happens on the dev branch (or feature branches merged into dev).
• main is protected — changes land only via pull request from dev.
• Production builds are cut by tagging a release (v*) off main.

CI / container image

Forgejo Actions handles:

• Tests on push to dev and on PRs into main.
• Container image build + push to the Forgejo registry on merge to main (:main) and on v* tags (:<version>).

Task and milestone tracking: Fable (Minstrel project, id 12).