Skip to content

Plugin Autotagger

Jump to bottom
Derrik Diener edited this page Jul 16, 2026 · 1 revision

Autotagger Plugin

Enabled by Default: Yes (Disable via SUPERNOVA_PLUGIN_AUTOTAGGER=false)

Purpose

The Autotagger acts as a background librarian, actively fixing missing metadata for your files using external APIs.

Technical Internals

  1. Queueing: During the initial fast-scan, tracks missing essential ID3/FLAC tags (like Artist or Album) are flagged.
  2. Acoustic Fingerprinting: The plugin asynchronously generates an AcoustID fingerprint of the audio file.
  3. MusicBrainz Match: It queries the MusicBrainz API using the fingerprint and duration.
  4. Database Update: When a high-confidence match is found, it silently updates the tracks, albums, and artists tables with the correct metadata, releasing the track from the "Unknown" bucket.

Note: The Autotagger deliberately avoids writing tags back to the physical audio files to respect file integrity.

API Execution

You can manually trigger this plugin from the web UI Settings page or via: POST /api/plugins/autotagger/run

Clone this wiki locally