Implement Navidrome Audiomuse AI plugin to Symfonium

CupcakKe · April 23, 2026, 1:56pm

I saw few commits to the opensubsonic api on their github, i think the dev of audiomuse made the base changes needed to the api but i don’t know if it’s gonna be available soon, i hope tho!

rubenmb · April 23, 2026, 5:11pm

Just adding my interest to this feature here! Very excited for it.

neptunehub · April 27, 2026, 7:28pm

@Tolriq juat want to share that Navidrome implemented the new Sonic Similarity API in this PR:

github.com/navidrome/navidrome

feat(subsonic): add sonicSimilarity extension as plugin capability (#5419)

master ← feat/sonic-similarity-plugin

aperto 01:32PM - 27 Apr 26 UTC

deluan

+2078 -357

### Description Implements the [OpenSubsonic `sonicSimilarity` extension (v1)](…https://opensubsonic.netlify.app/docs/extensions/sonicsimilarity/) as a plugin capability. This adds two new Subsonic API endpoints — `getSonicSimilarTracks` and `findSonicPath` — that delegate to a WASM plugin for audio-based similarity. The similarity logic is not implemented in Navidrome itself; Navidrome only provides the plumbing to delegate to plugins. If a plugin implements the `SonicSimilarity` capability, the extension is advertised in `getOpenSubsonicExtensions` and the endpoints return `sonicMatch` entries with similarity scores. If no plugin is available, the extension is not advertised and the endpoints return HTTP 404. **Key design decisions:** - Endpoints use `handlerRaw` (not `handler`) to return HTTP 404 directly when no provider is available, since a missing plugin means the functionality doesn't exist rather than a data-not-found error - Routes are always registered (not conditional) — the handlers themselves return 404 - Three-tier type layering: `capabilities.SonicMatch` → `sonic.SimilarResult` → `sonic.SimilarMatch` to maintain clean package boundaries - New `MatchSongsToLibraryMap` in the matcher returns `map[int]model.MediaFile` to preserve similarity score ordering through the matching pipeline - The `core/sonic` package defines a `capabilitySonicSimilarity` constant locally (unexported) since importing the `plugins` package constant would create an import cycle ### Related Issues None — this is a new extension implementation. ### Type of Change - [ ] Bug fix - [x] New feature - [ ] Documentation update - [ ] Refactor - [ ] Other (please describe): ### Checklist - [x] My code follows the project's coding style - [x] I have tested the changes locally - [ ] I have added or updated documentation as needed - [x] I have added tests that prove my fix/feature works (or explain why not) - [x] All existing and new tests pass ### How to Test 1. **Without a sonic similarity plugin installed:** - Call `getOpenSubsonicExtensions` — should NOT include `sonicSimilarity` - Call `getSonicSimilarTracks?id=any` — should return HTTP 404 - Call `findSonicPath?startSongId=any&endSongId=any` — should return HTTP 404 2. **With a sonic similarity plugin installed:** - Call `getOpenSubsonicExtensions` — should include `sonicSimilarity` (version 1) - Call `getSonicSimilarTracks?id=<valid-song-id>&count=5` — should return `sonicMatch` entries with `entry` and `similarity` fields - Call `findSonicPath?startSongId=<id1>&endSongId=<id2>&count=10` — should return path entries with similarity scores - Verify missing required params return subsonic error responses - Verify non-existent song IDs return subsonic error responses 3. **Run the test suite:** ```bash make test ``` ### Additional Notes **New files and packages:** - `plugins/capabilities/sonic_similarity.go` — Capability interface and request/response types - `core/sonic/sonic.go` — Core service orchestrating: MediaFile lookup → plugin call → matcher resolution - `plugins/sonic_similarity_adapter.go` — WASM plugin adapter implementing `sonic.Provider` - `server/subsonic/sonic_similarity.go` — Thin HTTP handlers - `plugins/pdk/go/sonicsimilarity/` — Generated PDK for plugin authors (via `make gen`) - `plugins/testdata/test-sonic-similarity/` — Testdata WASM plugin for integration testing **Test coverage:** - Unit tests for `core/sonic` service (provider check ordering, error paths, match resolution) - Unit tests for `core/matcher.MatchSongsToLibraryMap` (index preservation, partial matches) - Unit tests for `sonicSimilarity` extension advertisement (with/without provider) - Integration tests for the WASM adapter via testdata plugin (round-trip through plugin, error injection) - Snapshot tests for `sonicMatch` XML/JSON serialization - E2E tests for both endpoints with mock provider (happy path, count parameter, missing params, non-existent IDs, JSON structure validation) - E2E tests for 404 behavior when no plugin is available

They will be merged soon and then put in the next release but can be already be tested with the Navidrome image of the pr:

deluan/navidrome:pr-5419

Also AudioMuse-AI plugin v8 already implemented them in this release:

Real example of call can be also be found in the Navidrome’s PR but anyway are the same of the Open Subsomic api documentation.

Please remember that AudioMuse-AI on song path don’t implement similarity ao it return -1 as per the documentation.

spoonkuh · April 27, 2026, 10:16pm

this is so hype, only a matter of time until it’s available in symfonium smart flows

TheKingPin · April 28, 2026, 3:16pm

And Tolriq does the mic drop. Ladies and gentlemen the time is near

evilnick · April 28, 2026, 5:28pm

Just for anyone else who had no idea what you meant by this - check the Changelog for 15.0.0 beta 1!

Literally cannot wait (but am choosing to in an attempt to pretend I am being mature)

TheKingPin · May 6, 2026, 4:56am

Can confirm that this is working with latest beta v15.

For everyone else, dont forget to completely close and open Symfonium for the Smart Flow options to show (like me)

BobiderBob · May 18, 2026, 10:32am

Hmm i also set this up. I am currently on v15 beta 1. Instant Mix through navidrom web ui works (I can see the logs in audio muse ai container), but smart flow is blacked out and I’m pretty sure smart queue doesn’t work either o_0

spoonkuh · May 18, 2026, 10:50am

don’t forget that you should also be on the deluan/navidrome:pr-5419 image of navidrome where sonic similarity support is implemented

TheKingPin · May 18, 2026, 10:53am

Make sure you are at least on deluan/navidrome:pr-5419 or above, also make sure your on the latest audiomuse ai plugin version.

Also you might need to completely kill symfonium and reopen it. At least I had to do that before the options became available.

BobiderBob · May 18, 2026, 11:35am

Thanks for the answers. I changed the image to exactly deluan/navidrome:pr-5419 and now it works
Why is the docker compose in the NV plugin repo deluan/navidrome:latest. Am I missing something?
How can I track this PR, those I can find are merged already.

Cheers

TheKingPin · May 18, 2026, 11:53am

Because “latest” refers to a stable version, which should be used by default.

The Navidrome opensubsonic extension got added in “pr-5419”. But this is a pull request into the master and should not really be used in production environments. But, because myself, and, the rest here are so impatient to try this beautiful feature, we use it anyways

evilnick · June 4, 2026, 9:29pm

[Totally re-wrote my reply. Ahem]

Beta 2 of Symfonium 15, Navidrome AMA plugin v8, and the latest AMA release. AMA has now fully scanned my entire music library.

One thing I’ve been particularly enjoying before moving to the Symfonium beta was Navidrome’s Instant Mix feature.

My workflow was:

Pick a seed song in Navidrome
Use Instant Mix
Save the results as a playlist
Import that playlist into Symfonium
Listen

The results have been excellent. It feels very much like “pick one song and AMA finds a chain of sonically related songs”.

What I’d like to understand is whether there’s a way to recreate that same behaviour directly within Symfonium.

What I’ve observed so far:

Instant Mix

Selecting a song and choosing Instant Mix appears to be entirely internal to Symfonium.
I don’t see any corresponding AMA API calls in the logs.

Radio Mix

Selecting a song and choosing Radio Mix does generate AMA activity.
However, the resulting playlist often feels heavily concentrated around a small number of artists (e.g. ~5 artists with many tracks from each).

Smart Queue

Smart Queue is set to “Tracks [Sonic-analysis-based]”.
Changing Smart Flow modes definitely changes behaviour.
AMA logs show repeated calls to /api/similar_tracks.

For example, I can see calls such as:

GET /api/similar_tracks?eliminate_duplicates=true&item_id=...&n=25&radius_similarity=true

and AMA returns 25 similar tracks successfully.

This makes me wonder whether the closest equivalent to Navidrome Instant Mix is actually Smart Queue + Sonic-analysis mode rather than Radio Mix.

Is there currently a way within Symfonium to get behaviour equivalent to:

“Start from this seed track and keep extending the queue using AMA similar-track results”

or is Navidrome Instant Mix doing something that Symfonium does not currently expose?

I’m mainly trying to recreate the excellent “pick one song and let AMA take me on a journey” experience that I currently get through Navidrome Instant Mix.

TheKingPin · June 5, 2026, 5:41am

Under media providers in Symfonium did you set

“User similar tracks for radio mix” to on?

Because, when I start a radio mix I can see in Navidrome logs that similar_tracks Audiomuse AI API gets called.

evilnick · June 5, 2026, 10:47am

Gah! Yep, I hadn’t toggled that toggle. It’s working like a charm now - thanks for the heads-up on that setting, dude

evilnick · June 8, 2026, 9:02pm

For anyone who’s been tempted by this but didn’t want to run a PR version of Navidrome, the release which includes this has now been released: Release v0.62.0 · navidrome/navidrome · GitHub