v1.23.0

canticle v1.23.0

Highlights

When no lyrics service can find a track, canticle listens to the audio and decides whether it is an instrumental. That is a real result, and the statistics page was barely counting it. It credited the audio detector with a few hundred settled tracks when the true figure was several thousand: everything it resolved before it became a tracked source was never recorded against it. The one part of canticle that needs no lyrics service at all looked like the least productive thing it does. This release corrects the record in a single pass the first time the new version starts.

Correction, added after release: install v1.23.1 instead. This release corrected only the Prometheus counters. The dashboard's detector tile reads a different table that this release did not touch, so on the dashboard nothing changed and the promise below went unfulfilled. v1.23.1 fixes that and covers both.

Expect the number to jump, and expect it only once. On a decent-sized library the detector's result count climbs several-fold the moment you upgrade. That is the correction arriving, not a fault, and it does not repeat on later restarts.

One half of the history could not be recovered, and has been left alone rather than guessed at. Successful detections could be reconstructed exactly, because each one settles a track permanently and leaves an unambiguous record. Failed attempts could not: canticle knows how many times a track was passed over but not when, and the detector has not always existed, so some of those attempts happened before it was there to fail. Filling that in would have meant crediting work to something that was not running yet, with a precise-looking number to make it look certain. The gap is documented instead. The practical effect is that the Prometheus metrics and the dashboard's own tile still disagree about the detector's failures, on purpose.

What's changed

Fixed

• The statistics behind /metrics now credit the audio detector for the tracks it settled before it became a tracked source, correcting a long-standing undercount in a one-time pass at startup (#548)

Changed

• Reports and the dashboard now call it the "Instrumental Detector" rather than the bare "detector", matching the name the configuration has always used (#539)

Maintenance

• CI action bumps: actions/setup-python to 7.0.0, anthropics/claude-code-action to 1.0.178 (#562, #563)

Upgrading

Nothing to do. The correction runs by itself during the database upgrade on first start, takes effect once, and records that it has run so a later restart does not apply it twice. No command, no flag, and nothing is rewritten in your library.

The only thing worth knowing is the one above: your detector figures will step up sharply and stay there.

---

Docker: docker pull ghcr.io/sydlexius/canticle:1.23.0

Full changelog: v1.22.0...v1.23.0