Сведения о фильмах и сериалах (TMDB и OMDb)

Oulim узнаёт фильм или сериал по имени файла, а затем загружает постер и описание из сервисов с информацией о кино. Сведения о сериалах загружаются и без ключа, а для фильмов и рейтингов достаточно один раз добавить бесплатный ключ API.

Что даёт ключ

Страница фильма со сведениями — фон, логотип, возрастной рейтинг, жанры, рейтинги, съёмочная группа, награды, похожие фильмы
Страница фильма со сведениями — фон, логотип, возрастной рейтинг, жанры, рейтинги, съёмочная группа, награды, похожие фильмы
ИсточникЧто даётКлюч
TMDBФильмы, сериалы и люди; постеры, фоны и логотипы; описание, актёры, жанры, возрастной рейтинг, похожие фильмыНужен (бесплатно)
TVmazeСериалы, сезоны и эпизоды (дата выхода, название и описание эпизода, кадры), актёрыНе нужен
OMDbРейтинги IMDb, Rotten Tomatoes и Metacritic, награды. Запасной источник для фильмов, которых нет в TMDBНужен (бесплатно, 1000 запросов в день)
  • Без ключей сведения о сериалах берутся из TVmaze, а фильмы показываются только с именем файла и кадром из видео.
  • Одного ключа TMDB хватает, чтобы заполнить почти все экраны. Если нужны ещё и рейтинги, добавьте ключ OMDb.
  • Сведения загружаются один раз при добавлении в медиатеку и хранятся на этом устройстве. Ими ни с кем не делятся, а история просмотра никуда не отправляется.

Как получить ключ TMDB

  1. Зарегистрируйтесь на themoviedb.org и войдите в аккаунт.
  2. В меню аккаунта откройте Настройки › API и запросите ключ API. Выберите личное использование, а поля с названием и описанием приложения заполните коротко.
  3. Когда ключ выдадут, скопируйте ключ API (API Key, короткий) или токен доступа для чтения API (API Read Access Token, длинный). Подойдёт любой из них.

Как получить ключ OMDb

  1. На omdbapi.com в меню API Key запросите бесплатный ключ (FREE).
  2. Найдите ключ в письме и обязательно перейдите по ссылке активации из того же письма. Пока вы этого не сделаете, ключ не заработает.

Как добавить ключ в приложение

  1. Откройте Настройки › Медиатека и прокрутите вниз до раздела Метаданные.
  2. Вставьте ключ в поле Ключ API TMDB и нажмите Сохранить. Приложение один раз проверит его в TMDB и сообщит: Ключ подходит · Загружаем сведения.
  3. Ключ OMDb добавляется так же — в поле Ключ API OMDb.
  4. После сохранения ключа сведения для медиатеки начнут загружаться заново автоматически. Если фильмов много, это может занять несколько минут.
  • Ключи хранятся только в защищённом хранилище этого устройства. На экране видны лишь четыре последних символа бледным шрифтом.
  • Если появилось Этот ключ не подошёл, проверьте, нет ли пробелов в начале или в конце, а для OMDb — перешли ли вы по ссылке активации.
  • Постеры и описания загружаются на языке приложения. Если сменить язык приложения в Настройки › Язык, Oulim догрузит сведения только для тех фильмов и сериалов, у которых их на этом языке ещё нет.

Если устройств несколько

  • Для видео с Oulim PC используются сведения, которые выбрал ПК. Добавлять ключ на каждый телефон и телевизор не нужно, а исправления на ПК появляются сразу на всех устройствах.
  • Если ключ есть только на ПК, зарегистрированные устройства получат его при подключении к ПК. И наоборот: ключ, добавленный на первом зарегистрированном телефоне (управляющем устройстве), получит ПК. Если там уже есть другой ключ, он не перезаписывается.
  • На устройства, где вводить ключ неудобно (например, на телевизор), Ключи метаданных можно передать с телефона через Отправить настройки («Перенос файлов и настроек между устройствами»).

Если сведения неверные

Исправить совпадение — поиск вариантов по запросу и году, выбор, закрепление данных
Исправить совпадение — поиск вариантов по запросу и году, выбор, закрепление данных
  1. Внизу страницы фильма, в блоке Неверные данные?, нажмите Исправить совпадение.
  2. Исправьте Запрос и Год, найдите нужный вариант в Совпадения и нажмите Выбрать.
  3. Если включить Закрепить данные, сведения не изменятся при повторной загрузке. Чтобы полностью убрать неверные сведения, нажмите Удалить данные файла.

Совет Если исправить сведения для видео с ПК на телефоне или телевизоре, на ПК уйдёт запрос на изменение. Когда вы одобрите его в Уведомления на ПК, изменения появятся на всех устройствах.

Чтобы фильмы сразу распознавались правильно, называйте файлы в формате «Название (год)». Подробные правила — в руководстве «Как разложить файлы и папки».

Источники

Сведения о фильмах и сериалах предоставляют TMDB, TVmaze и OMDb. Oulim использует TMDB API, но не одобрен и не сертифицирован TMDB. Источники также указаны в разделе О приложении и Pro.