bvandeusen/minstrel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 38 Wiki Activity
162 Commits 2 Branches 38 Tags
86b024dc47a0b0bfc4c3d58d0a9aa1270e01ee7d
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
bvandeusen 86b024dc47 feat(web): scaffold SvelteKit SPA with Tailwind + adapter-static 
- SvelteKit 2.x + Svelte 5 + TypeScript + Vite 5
- adapter-static with fallback:'index.html' for SPA deep-link routing
- Tailwind configured with dark-only palette matching spec
- Placeholder landing page at /
- Committed web/build/index.html placeholder (via .gitignore negation) so
  go:embed works before the SvelteKit build has been run
2026-04-22 09:26:36 -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
style: gofmt fixes across api package
2026-04-21 23:02:20 -04:00
web
feat(web): scaffold SvelteKit SPA with Tailwind + adapter-static
2026-04-22 09:26:36 -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%