Repository navigation
Install
Cadence ships as a Docker image (multi-arch: amd64 and arm64).
Try it in demo mode (fake search results and request queue, no setup, no external calls):
docker run --rm -p 8000:8000 -e DEMO_MODE=true ghcr.io/jay739/cadence:0.1.0Then open http://localhost:8000.
Run it for real with Docker Compose: follow the Quickstart and set image: ghcr.io/jay739/cadence:0.1.0 in docker-compose.yml to use this release instead of building locally. The optional YouTube fallback service is ghcr.io/jay739/cadence-ytdlp-shim:0.1.0.
Put Cadence behind your reverse proxy for TLS; it listens on port 8000 and does not terminate TLS itself.
What's Changed
- fix(ci): stop pip-audit trying to git-clone this private repo by @jay739 in #21
- Fix two fulfillment bugs found on the first real deployment by @jay739 in #1
- Authenticate against Navidrome so library users sign in with their own credentials by @jay739 in #20
- deps(backend): update cryptography requirement from <44.0,>=43.0.0 to >=43.0.0,<51.0 in /backend by @dependabot[bot] in #7
- deps(backend): update pytest-cov requirement from <6.0,>=5.0.0 to >=5.0.0,<8.0 in /backend by @dependabot[bot] in #2
- deps(backend): update argon2-cffi requirement from <24.0,>=23.1.0 to >=23.1.0,<26.0 in /backend by @dependabot[bot] in #4
- deps(backend): update mypy requirement from <2.0,>=1.12.0 to >=1.12.0,<3.0 in /backend by @dependabot[bot] in #6
- deps(backend): update structlog requirement from <25.0,>=24.4.0 to >=24.4.0,<27.0 in /backend by @dependabot[bot] in #3
- deps(actions): bump the actions group with 9 updates by @dependabot[bot] in #5
- deps(web): bump the web-deps group in /web with 16 updates by @dependabot[bot] in #8
- deps(web): bump @types/node from 24.13.3 to 26.4.1 in /web by @dependabot[bot] in #9
- deps(web): bump @testing-library/jest-dom from 6.9.1 to 7.0.1 in /web by @dependabot[bot] in #10
- deps(web): bump vitest from 4.1.10 to 5.0.0 in /web by @dependabot[bot] in #12
- Add ytdlp-shim as a third, last-resort YouTube fulfillment tier by @jay739 in #23
- Resolve the high-severity transitive dependency advisories by @jay739 in #33
- Make the auth rate limit configurable, and raise it for the e2e harness by @jay739 in #32
- Add per-user webhook notifications for approved/fulfilled requests by @jay739 in #27
- Add paste-a-link track resolution for Spotify and Apple Music by @jay739 in #29
- Fall through to next-best candidate on failure, and let requesters retry by @jay739 in #24
- Add a manual light/dark theme toggle by @jay739 in #25
- Add a profile page with request stats and account settings by @jay739 in #30
- Let an admin choose per integration whether env or settings wins by @jay739 in #28
- Give the app's surfaces a frosted-glass treatment by @jay739 in #31
- Add a restrained fade transition between main routes by @jay739 in #26
- Fix test connection on env-configured installs, nav highlighting, and the theme flash by @jay739 in #34
- Navidrome foundation: already-in-library check, generated avatars, richer user details by @jay739 in #35
- Ask for a quality, not a container, and never downgrade one silently by @jay739 in #36
- Keep server infrastructure detail out of the public health endpoint by @jay739 in #37
- Refuse a download the library has no room for by @jay739 in #38
- Add hover affordances across the app, and make the theme toggle's rotation legible by @jay739 in #39
- Merge the two search inputs into one, and move the source picker out of the settings page by @jay739 in #40
- Add a home page and admin insight, and actually route the home page by @jay739 in #41
- Tag Opus and M4A files, and write the metadata we can actually verify by @jay739 in #42
- Show real download progress, and name the source that delivered a track by @jay739 in #43
- Let a requester override a wrong automatic pick by @jay739 in #44
- Release 0.1.0 by @jay739 in #51
- Cap SQLAlchemy below 2.1 for the 0.1.0 release by @jay739 in #52
New Contributors
- @jay739 made their first contribution in #21
- @dependabot[bot] made their first contribution in #7
Full Changelog: https://github.com/jay739/cadence/commits/v0.1.0