## setup

무료 키 두 개, 5분이면 끝.

MediaPorter는 라이브러리를 풍부하게 하기 위해 두 가지 외부 서비스를 사용합니다: TMDb는 포스터와 작품 메타데이터, OpenSubtitles는 파일에 아직 포함되지 않은 언어의 자막을 제공합니다. 둘 다 개인 사용은 무료이며 계정만 있으면 됩니다.

  • 왜 본인 키가 필요한가: 공용 키를 앱에 내장하면 며칠 안에 바이너리에서 추출되고, 곧 속도 제한이나 차단으로 이어져 모두가 사용할 수 없게 됩니다. 사용자별 키만이 MediaPorter를 장기적으로 동작하게 하는 방법입니다.
  • 키 없이 사용한다면: 파일 동기화는 여전히 됩니다. TMDb 없음 — 생성된 폴백 포스터와 최소한의 메타데이터. OpenSubtitles 없음 — 파일에 이미 포함된 자막만 사용.
  • 개인정보: 키는 Mac에 보관됩니다. MediaPorter는 사용자 컴퓨터에서 직접 TMDb와 OpenSubtitles에 접속합니다 — 저희 서버를 거치지 않습니다.
빌드

맞는 다운로드 빌드를 선택하세요.

MediaPorter는 두 가지 macOS 빌드로 배포됩니다. 앱 동작은 같고, 리먹스나 오디오 변환에 필요한 ffmpeg를 어디서 가져오는지만 다릅니다.

ffmpeg 포함 빌드

ffmpeg가 앱 번들 안에 포함되어 있습니다. 가장 간단한 선택이며 Homebrew나 명령줄 설정이 필요 없습니다.

시스템 ffmpeg 빌드

다운로드 크기가 더 작습니다. `brew install ffmpeg` 등으로 직접 설치하거나, 호환되는 ffmpeg 바이너리가 PATH에 있도록 설정하세요.

tmdb

TMDb — 포스터·메타데이터

분석 단계에서 영화, 드라마, 애니메이션을 식별하고 포스터 및 TV 앱이 사용하는 전체 필드 세트(시즌, 에피소드 번호, 정렬 제목)를 가져오는 데 사용됩니다. 키가 없으면 — 생성된 폴백 포스터와 파일명이 제목으로 사용됩니다.

  1. themoviedb.org에 가입 — 무료, 신용카드 불필요. 사용자 이름과 이메일만 있으면 됩니다.
  2. 계정 → Settings → API.
  3. 「Request an API key」→「Developer」 클릭. 유형은 「Personal」, 약관 동의.
  4. 「API Key (v3 auth)」 복사 — 긴 16진수 문자열.
  5. MediaPorter에서: Settings (⌘,) → Metadata → 키 붙여넣기 → Save.

// TMDb 무료 등급은 개인 사용 기준 사실상 무제한입니다 — 대규모 라이브러리를 동기화해도 일일 다운로드 한도에 걸리지 않습니다.

TMDb API 키 발급받기 →
opensubtitles

OpenSubtitles — 다국어 자막

분석 단계에서 설정한 언어(예: en, ru)의 자막을 찾고 다운로드하는 데 사용됩니다 — 파일에 아직 포함되지 않은 경우에 한해. 다운로드된 SRT는 출력 파일에 재멀티플렉싱되어 TV 앱의 자막 스위처에 나타납니다.

  1. opensubtitles.com에 가입 — 무료, 신용카드 불필요.
  2. opensubtitles.com/consumers로 가서 「New consumer」 클릭. 이름은 자유(예: 「MediaPorter on my Mac」). API 키 복사.
  3. MediaPorter에서: Settings (⌘,) → Subtitles → API 키, opensubtitles.com 계정 사용자명·비밀번호, 원하는 언어(예: en,ru) 입력 → Save.

// 등록된 무료 계정은 하루 20개의 자막 다운로드를 제공합니다 — 영화 한 편이나 몇 화 정도는 충분하지만, 24화짜리 한 시즌을 한 번에 동기화하기에는 빠듯합니다. OpenSubtitles VIP(연 약 $10)는 한도를 크게 늘려 주며, 대규모 라이브러리를 다룬다면 권장됩니다.

OpenSubtitles API 키 발급받기 →

두 키를 모두 입력한 후

이미 드롭한 폴더에 「분석」을 다시 실행하세요 — MediaPorter가 이전에 건너뛴 파일들의 포스터와 자막을 채워 넣습니다. TV 앱에 이미 들어간 항목은 변경되지 않으며, 보강은 새 파일이나 다시 분석된 파일에만 적용됩니다.

macOS용 다운로드