Skip to content

Plugins

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

Plugin System

Supernova's backend features a robust, extensible Plugin Manager that handles background tasks and third-party API integrations without blocking the main web server.

Media Integrity Plugins

Album Merger & Artist Merger

Sometimes metadata scanners get it wrong, or your folders are disorganized.

  • How it works: These plugins scan the database for duplicate albums or artists (based on strict string matching algorithms) and consolidate them into a single canonical record.
  • Safety: They utilize database transactions to seamlessly migrate tracks and "hearts", then prune the duplicate entries.

Deduper

Hides or eliminates duplicate tracks within the same album, ensuring a clean listening experience without manually deleting files.

Autotagger

Runs intelligently in the background to fetch missing metadata for poorly tagged files.

External Integrations

Last.fm Scrobbling

Supernova natively supports Last.fm authentication and scrobbling.

  • Follows the official Last.fm API guidelines strictly: tracks are scrobbled only after 50% of the track has played, or after 4 minutes (whichever comes first).
  • Prevents spamming Last.fm by caching the scrobble state until the track actually changes.

LRCLib (Lyrics)

Automatically fetches time-synced lyrics for the currently playing track by matching the artist, album, and track name against the LRCLib open database. The frontend caches these requests to prevent unnecessary network traffic.

Podcasts

Supernova isn't just for local music; it has a built-in podcast manager.

  • Search for podcasts using the PodcastIndex API.
  • Subscribe to feeds, browse episodes, and stream directly within the Supernova UI.
  • The podcast player syncs your playback position so you never lose your spot.

Clone this wiki locally