About disc.guide

A disc can hold dozens of titles: the movie, alternate cuts, extras, trailers, and a pile of menus. disc.guide records which is which, so the next person ripping the same disc doesn't have to guess.

How a disc is recognised

When a disc is scanned, the ripping software builds a fingerprint from its structure: the disc label, how many titles there are, and each title's length, size and chapter count. That is hashed into a short ID. Every copy of the same release produces the same ID, so a match is exact and needs no guesswork.

A fingerprint says nothing about the person who scanned it. disc.guide stores the disc's structure and which movie or show it is. No file names, no libraries, no accounts.

Adding discs

Discs are added automatically by Media Hub, a home media manager, after a rip is checked and filed. Adding is invite-only for now, to keep the data clean.

API

Reading is open to anyone. Please be gentle: cache what you look up.

GET  /api/fingerprints/{hash}
     → { found: true, fingerprint: { hash, tmdbId, mediaType, title, year?, playlist? } }
     → 404 { found: false }

GET  /api/fingerprints/browse?q=&page=&pageSize=
     → { page, pageSize, total, results: [...] }

POST /api/fingerprints/search
     { fingerprint: DiscFingerprint, threshold: 0..1 }
     → { matches: [{ hash, tmdbId, title, confidence }] }

The playlist lists MakeMKV title numbers with a role (feature, episode, bonus).