## setup

Two free API keys, five minutes.

Name: MediaPorter
Author: MediaPorter

MediaPorter uses two third-party services to enrich your library: TMDb for posters and show metadata, and OpenSubtitles for downloading missing-language subtitles. Both are free for personal use and need only an account.

Why your own keys: a single shared key bundled in the app would get extracted from the binary in minutes, then rate-limited or revoked — breaking the app for everyone. Per-user keys keep MediaPorter working long-term.
What if you skip them: the app still syncs your files. TMDb missing → generated fallback posters and minimal metadata. OpenSubtitles missing → only the subtitles already embedded in your files are used.
Privacy: keys stay on your Mac. MediaPorter talks directly to TMDb and OpenSubtitles from your machine — nothing routes through us.

builds

Choose the right download build.

MediaPorter is distributed in two macOS builds. The app behavior is the same; the difference is how ffmpeg is provided for files that need remuxing or audio conversion.

Bundled ffmpeg

Includes ffmpeg inside the app bundle. This is the simplest option and does not require Homebrew or any command-line setup.

System ffmpeg

Smaller download. Install ffmpeg yourself, for example with `brew install ffmpeg`, or make any compatible ffmpeg binary available in your PATH.

tmdb

TMDb — posters & metadata

Used during Analyze to identify movies, TV shows, and anime, then fetch posters and the full TV-app field set (seasons, episode numbers, sort titles). Without it, you get a generated fallback poster and the filename as the title.

Sign up at themoviedb.org — free, no credit card. A username and email is all it asks.
Open your account → Settings → API.
Click "Request an API key" → "Developer." Use type: "Personal," tick the terms.
Copy the v3 auth API key (a long hex string).
In MediaPorter: Settings (⌘,) → Metadata → paste the key → Save.

// The free TMDb tier is essentially uncapped for personal use — there's no daily download limit you'll hit syncing a library, even a large one.

Get a TMDb API key →

opensubtitles

OpenSubtitles — multi-language subtitles

Used during Analyze to find and download subtitle tracks in the languages you've configured (e.g. en, ru) when they're not already embedded in your file. The downloaded SRTs are remuxed into the output so they appear in the TV app's subtitle switcher.

Sign up at opensubtitles.com — free, no credit card.
Go to opensubtitles.com/consumers and click "New consumer." Give it any name (e.g. "MediaPorter on my Mac"). Copy the API key.
In MediaPorter: Settings (⌘,) → Subtitles → paste the API key, your account username, your password, and the languages you want (e.g. en,ru) → Save.

// Registered free accounts get 20 subtitle downloads per day — fine for a movie night or a few episodes, tight for binge-syncing a 24-episode season in one go. OpenSubtitles VIP (~$10/year) raises the limit substantially and is the right call if you sync large libraries.

Get an OpenSubtitles API key →

After you've pasted both keys

Re-run Analyze on any folder you've already dropped — MediaPorter will fill in posters and subtitles for files it skipped before. Existing items in the TV app aren't touched; the upgrade only applies to new or re-analyzed files.

Download for macOS