bvandeusen/minstrel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 38 Wiki Activity
166 Commits 2 Branches 38 Tags
75ce65c80e59447348915b8def0ad5086f02adfd
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
bvandeusen 75ce65c80e feat(server): serve embedded SPA at root with /api,/rest carve-out 
- NotFound wrapper routes unknown /api/* and /rest/* to a JSON 404
- Everything else falls through to the embedded web handler, which
  resolves static assets or returns index.html for SPA deep links
2026-04-22 10:31:30 -04:00
.forgejo/workflows
ci(release): use REGISTRY_TOKEN secret for Forgejo registry push
2026-04-18 23:29:15 +00:00
cmd/minstrel
feat(cmd): plumb SubsonicConfig into server.New
2026-04-19 17:40:24 +00:00
docs
docs: add Plan 3 web UI media endpoints implementation plan
2026-04-21 22:02:55 -04:00
internal
feat(server): serve embedded SPA at root with /api,/rest carve-out
2026-04-22 10:31:30 -04:00
web
refactor(web): move embed package to web/ so go:embed reaches build/
2026-04-22 10:29:31 -04:00
.env.example
M1/#291: document SMARTMUSIC_* env vars + test DSN
2026-04-19 01:12:35 +00:00
.gitignore
docs: add web UI scaffold design spec
2026-04-20 19:18:04 -04:00
.golangci.yml
ci(lint): drop revive exported rule; require no doc-comment boilerplate
2026-04-18 21:47:40 +00:00
config.example.yaml
docs: refresh config.example.yaml with auth/library/subsonic sections
2026-04-19 17:40:36 +00:00
docker-compose.yml
fix(auth): set subsonic_password on admin bootstrap
2026-04-19 18:30:54 -04:00
Dockerfile
feat(skel): multi-stage Dockerfile for minstrel runtime
2026-04-18 21:20:54 +00:00
go.mod
M1/#293: add dhowden/tag dep for library scanner
2026-04-19 15:11:40 +00:00
go.sum
M1/#293: go.sum for dhowden/tag
2026-04-19 15:14:56 +00:00
LICENSE
Initial commit
2026-04-18 17:33:35 +00:00
Makefile
M1/#292: add Makefile with sqlc generate + test/lint/build
2026-04-19 02:31:06 +00:00
README.md
docs: expand README with spec links and dev workflow
2026-04-18 18:05:38 +00:00
sqlc.yaml
M1/#292: sqlc v2 config → dbq package via pgx/v5
2026-04-19 02:31:10 +00:00

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).

Reference in New Issue View Git Blame Copy Permalink
S
Description
Self-hosted music server with OpenSubsonic compatibility, server-side smart shuffle, dual-like model, session-aware radio, and Lidarr integration. Go + Postgres.
Readme MIT 63 MiB
Releases 38
v2026.07.02 — Android auto-recovery: failed loads heal on reconnect Latest
2026-07-02 16:45:36 -04:00
Languages
Go 39.2%
Kotlin 25%
Dart 14.2%
TypeScript 12%
Svelte 9.3%
Other 0.1%