MediaPorter.md
EnglishРусский中文한국어
## setup

Два бесплатных ключа за пять минут.

MediaPorter обогащает библиотеку через два сторонних сервиса: TMDb даёт постеры и метаданные сериалов и фильмов, OpenSubtitles — субтитры на тех языках, которых ещё нет в файле. Оба бесплатны для личного использования и требуют только аккаунта.

  • Почему свои ключи: общий ключ, зашитый в приложение, за пару дней выковыривают из бинарника, после чего его блокируют по rate limit — и сервис ломается у всех. Личные ключи у каждого пользователя — единственный способ, чтобы MediaPorter работал долго.
  • Если пропустить: приложение всё равно зальёт файлы на устройство. Без TMDb — будет сгенерированный фоллбэк-постер и минимум метаданных. Без OpenSubtitles — только субтитры, уже встроенные в файл.
  • Приватность: ключи хранятся у вас на Mac. MediaPorter ходит в TMDb и OpenSubtitles напрямую с вашей машины — ничего не идёт через нас.
билды

Выберите подходящую сборку.

MediaPorter распространяется в двух macOS-сборках. Поведение приложения одинаковое; отличается только то, откуда берётся ffmpeg для ремультиплексирования и конвертации аудио.

ffmpeg внутри приложения

ffmpeg уже лежит в .app. Это самый простой вариант: Homebrew и настройка командной строки не нужны.

Системный ffmpeg

Скачивание меньше. Установите ffmpeg сами, например через `brew install ffmpeg`, или положите совместимый бинарник ffmpeg в PATH.

tmdb

TMDb — постеры и метаданные

Используется на этапе Анализа, чтобы распознать фильмы, сериалы и аниме, подтянуть постеры и весь набор полей TV-приложения (сезоны, номера серий, сортировочные заголовки). Без ключа — сгенерированный фоллбэк-постер и имя файла как заголовок.

  1. Зарегистрируйтесь на themoviedb.org — бесплатно, без банковской карты. Нужны логин и email.
  2. Откройте свой аккаунт → Settings → API.
  3. Нажмите «Request an API key» → «Developer». Тип: «Personal», примите условия.
  4. Скопируйте «API Key (v3 auth)» — длинная шестнадцатеричная строка.
  5. В MediaPorter: Settings (⌘,) → Metadata → вставьте ключ → Save.

// Бесплатного тарифа TMDb для личного использования по сути хватает без ограничений — дневной лимит, в который можно упереться при синхронизации даже большой библиотеки, отсутствует.

Получить ключ TMDb →
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 →

Когда оба ключа вставлены

Запустите Анализ заново на уже добавленных папках — MediaPorter догрузит постеры и субтитры для файлов, которые пропустил раньше. То, что уже в TV-приложении, не трогается; обогащение применяется к новым и переанализированным файлам.

Скачать для macOS