docs(readme): document AcoustID API key + retag gotcha
The AcoustID section in the README was a one-liner that did not explain how to get the API key or why the retag action sometimes appears to do nothing. Expand the section with: - A short paragraph pointing users at acoustid.org/new-application and the Settings entry where the key belongs. - A note cross-referencing issue #704: the retag path treats an existing MUSICBRAINZ_TRACKID tag as a short-circuit, so removing the cached tag is the documented workaround. This gives a definitive answer until the retag path itself is fixed. No code or behavioural change.
This commit is contained in:
parent
117f52bb25
commit
3e117909da
1 changed files with 15 additions and 0 deletions
15
README.md
15
README.md
|
|
@ -105,6 +105,21 @@ SoulSync bridges streaming services to your music library with automated discove
|
||||||
- Catches wrong versions (live, remix, cover) even from streaming API sources
|
- Catches wrong versions (live, remix, cover) even from streaming API sources
|
||||||
- Fail-open design: verification errors never block downloads
|
- Fail-open design: verification errors never block downloads
|
||||||
|
|
||||||
|
#### AcoustID API key
|
||||||
|
|
||||||
|
AcoustID verification is opt-in. To enable it, request a free API key
|
||||||
|
at <https://acoustid.org/new-application> and paste it into
|
||||||
|
Settings → AcoustID. Without a key, downloads still complete but the
|
||||||
|
verification step is skipped silently.
|
||||||
|
|
||||||
|
If a track was previously tagged by AcoustID but the retag action in
|
||||||
|
the AcoustID Scanner no longer changes anything, see issue #704 — the
|
||||||
|
most common cause is that the file already carries a
|
||||||
|
`MUSICBRAINZ_TRACKID` tag, which the retag step uses as a short-circuit
|
||||||
|
and therefore never overwrites. Removing the cached
|
||||||
|
`MUSICBRAINZ_TRACKID` (and the `ACOUSTID_ID` if present) from the file
|
||||||
|
restores the retag.
|
||||||
|
|
||||||
### Metadata & Enrichment
|
### Metadata & Enrichment
|
||||||
|
|
||||||
**10 Background Enrichment Workers**: Spotify, MusicBrainz, iTunes, Deezer, Discogs, AudioDB, Last.fm, Genius, Tidal, Qobuz
|
**10 Background Enrichment Workers**: Spotify, MusicBrainz, iTunes, Deezer, Discogs, AudioDB, Last.fm, Genius, Tidal, Qobuz
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue