MovieMatch

FAQ

The useful bits.

Do I need a Trakt account?

No for the public catalogue. Personal watchlist, favorite, watched and rating actions require an existing or newly created Trakt account. Sign in on Trakt first, then authorize MovieMatch.

Does MovieMatch see my Trakt password?

No. Trakt handles sign-in. The Worker receives only an authorization code and exchanges it server-side; the Client Secret never reaches the browser.

Which actions write back to Trakt?

Watchlist, favorites, watched history, removal from history, and ratings from 1–10 are written to Trakt. MovieMatch refreshes the state after successful writes.

What do the card gestures do?

Swipe left to mark a title Not interested for MovieMatch matching. Swipe right to add it to your Trakt watchlist. Swipe up, or tap the eye, to mark it watched. Tap the card itself to open its full details.

What do the watched-date choices mean?

You can log the current time, Trakt's release date, another selected date, or an unknown date. For series, a normal tap logs the next unwatched aired episode; a long press preselects all aired regular episodes.

Why is Continue Watching read-only?

Real playback progress must come from a compatible player or scrobbler that knows the percentage watched. MovieMatch is not a video player and does not fabricate progress.

What are Not interested and Didn't finish?

They are MovieMatch-only matching signals. They help exclude bad candidates without creating a second rating system or changing Trakt playback data.

How are friend matches protected?

One person shares a private MovieMatch invite code. The other sends a request, and comparison remains blocked until the recipient explicitly accepts it.

Why can a security check appear?

MovieMatch uses Cloudflare Turnstile before Trakt sign-in, friend requests and permanent account deletion. The proof is short-lived, single-use and verified by the MovieMatch Worker before the action continues.

What is stored in D1?

Internal user IDs, initials, invite codes, approved connections, compact state snapshots containing Trakt IDs, MovieMatch-only signals, and active server sessions containing encrypted Trakt tokens. Full titles, artwork and passwords are not stored there.

Are Trakt images hotlinked?

No. The Worker retrieves and caches them before serving them to the app.