Skip to content

Plugin Deduper

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

Deduper Plugin

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

Purpose

Users often have multiple versions of the same album (e.g., a FLAC rip for archiving and an MP3 rip for mobile). The Deduper plugin prevents these duplicate tracks from cluttering the album tracklist in the UI.

Technical Internals

  1. Identification: The plugin queries tracks grouped by album_id and title (case-insensitive).
  2. Preference Algorithm: When duplicates are found within the same album, it prefers the track with the higher bitrate or the lossless format (FLAC over MP3).
  3. Masking (Not Deleting): Supernova's philosophy is "Your files are your files." The Deduper never deletes media from your hard drive. Instead, it adds the lower-quality duplicate to the internal ignored_files table or sets a hidden flag so it doesn't appear in the standard tracklist query.

API Execution

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

Clone this wiki locally