# Spinmatch

Spinmatch is a self-hosted music collection manager and YouTube link finder for homelab users who organize personal music libraries. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3333/spinmatch

## Description

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.

## Health score

55/100 (Fair), based on 3 of 4 factors.
- Maintained: 95 (last commit 6 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/spinmatch-0knrqyn0290r3v?q=Spinmatch

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3333/spinmatch), the self-hosted and open-source app directory.
