Spinmatch

Spinmatch is a self-hosted music collection manager and YouTube link finder for homelab users who organize personal music libraries.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Spinmatch is a self-hosted music collection manager and YouTube link finder for homelab users who organize personal music libraries. It searches MusicBrainz for artists, albums, and songs, browsing album art and tracklists, and verifies a YouTube link for a track by comparing the video's duration against the track length recorded in MusicBrainz. It also organizes a local folder of unsorted audio files into your library, tagging tracks automatically via AcoustID acoustic fingerprinting or through manual MusicBrainz search. Spinmatch only finds and verifies YouTube links and does not download or rip audio. A free MusicBrainz-compatible contact email is required; a free AcoustID application programming interface (API) key enables automatic fingerprint identification.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

55/100 Fair

Maintained
95last commit 6 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
1
Open issues
0
Last commit
2026-11-15
License
MIT
Activity
declining

Checked 6 days ago - source: GitHub (Yoshiofthewire/Spinmatch)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup requirements Spinmatch requires a free MusicBrainz-compatible contact email. The optional local-library ingest feature needs an Ingest Directory and a Music Directory configured. A free AcoustID API key additionally enables automatic fingerprint identification; without one, files are matched by their existing tags. source

Fetched 48 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does Spinmatch download or rip audio from YouTube?

No. It only finds and verifies YouTube links by comparing video duration to the MusicBrainz-recorded track length. It does not download audio.

How does Spinmatch mark a YouTube result as confirmed?

A result is Confirmed when the video duration is within five seconds of the MusicBrainz track length. Otherwise it shows the closest candidate as Unverified and reports the difference.

What local data does Spinmatch create when I point it at my music folder?

It indexes the directory into a local SQLite database. The index records fields such as artist, album, title, duration, track number, disc number, year, genre, format, file size, embedded cover art, and first-seen date.

Do I need an AcoustID API key to use Spinmatch's local ingest?

No. The ingest feature only needs an Ingest Directory and a Music Directory configured. An AcoustID API key enables automatic fingerprint identification, while without it files are matched by existing tags.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads