Плагин Кинопоиска для Emby: установка, настройка и решение проблем

Если фильмы в библиотеке Emby определяются без русских названий, описаний и постеров, причина почти всегда одна — стандартные провайдеры метаданных (TheMovieDb, TheTVDB) отдают данные на английском или не находят российские релизы, и эту задачу решает плагин Кинопоиска, который подтягивает описания, обложки и рейтинги напрямую с Kinopoisk.

Официального плагина от самого Кинопоиска в каталоге Emby нет — это важно понимать сразу. Речь идёт о сторонних разработках энтузиастов, которые распространяются через GitHub и подключаются к серверу вручную. Ниже разберём, как найти рабочий вариант, установить его и настроить так, чтобы библиотека выглядела аккуратно.

Что даёт плагин Кинопоиска в Emby

Emby устроен модульно: за получение информации о фильмах и сериалах отвечают провайдеры метаданных. Плагин добавляет Кинопоиск в список таких источников, и сервер начинает запрашивать у него данные при сканировании библиотеки.

На практике это означает:

  • 🎬 русские названия фильмов и сериалов вместо английских оригиналов;
  • 📝 описания и слоганы на русском языке;
  • 🖼️ постеры и фоны в хорошем качестве;
  • ⭐ рейтинг Кинопоиска рядом с оценками других баз;
  • 👥 корректные имена актёров и съёмочной группы кириллицей.

Особенно заметна разница на отечественном контенте: российские сериалы и фильмы, которых нет или почти нет в TheMovieDb, с плагином определяются корректно.

Где искать плагин и как проверить его безопасность

Поскольку плагин не входит в официальный каталог Emby, искать его нужно на GitHub по запросам вроде «emby kinopoisk plugin». Такие проекты периодически появляются, забрасываются и форкаются, поэтому точную ссылку имеет смысл искать свежую — через поиск GitHub с сортировкой по дате обновления.

Перед установкой стороннего DLL проверьте несколько вещей: дату последнего коммита, наличие открытого исходного кода, количество звёзд и issues с живыми обсуждениями. Заброшенный плагин может перестать работать после обновления сервера Emby, так как API плагинов меняется между версиями.

⚠️ Внимание: скачивайте плагин только из репозитория с открытым исходным кодом. Готовые DLL-файлы, размещённые на файлообменниках и форумах без публикации кода, — потенциальный источник вредоносного ПО, ведь плагин исполняется с правами сервера Emby.
📊 Откуда Emby берёт метаданные для вашей библиотеки сейчас?
Только стандартные провайдеры (TheMovieDb)
Уже стоит плагин Кинопоиска
Комбинирую несколько источников
Метаданные заполняю вручную

Установка плагина на сервер Emby

Процедура установки стороннего плагина в Emby одинакова для большинства таких разработок: файл .dll помещается в каталог плагинов сервера, после чего сервер перезапускается. Конкретный путь к папке зависит от того, как установлен Emby — нативно на Windows, на Linux или в Docker.

Общий порядок действий выглядит так:

  • 📥 скачайте релиз плагина (файл DLL) со страницы Releases репозитория;
  • 📂 найдите папку plugins в каталоге данных Emby — в Docker-установках она обычно лежит внутри примонтированного тома конфигурации;
  • 📋 скопируйте DLL в эту папку;
  • 🔄 перезапустите сервер Emby через веб-интерфейс или командой перезапуска контейнера;
  • ✅ откройте Панель управления → Плагины и убедитесь, что плагин появился в списке.
docker restart emby

Если плагин не появился в списке после перезапуска, первым делом откройте журнал сервера: Панель управления → Журналы. Ошибка загрузки сборки там видна явно — чаще всего это несовместимость версии плагина с версией Emby.

☑️ Проверка после установки плагина

Выполнено: 0 / 5

Настройка провайдеров метаданных

Установленный плагин сам по себе ничего не меняет — его нужно включить для конкретной библиотеки. Откройте Панель управления → Библиотеки, выберите нужную библиотеку и перейдите к настройкам метаданных. В списках загрузчиков метаданных и источников изображений появится новый пункт, связанный с Кинопоиском.

Порядок провайдеров в списке имеет значение: Emby опрашивает их сверху вниз и берёт данные от первого, кто вернул результат. Если хотите, чтобы русские названия имели приоритет, поднимите Кинопоиск выше TheMovieDb. Для смешанной библиотеки разумный вариант — оставить TheMovieDb основным для зарубежного контента и использовать Кинопоиск как дополнительный источник изображений и рейтингов, если плагин это позволяет.

После изменения настроек запустите обновление метаданных: в контекстном меню библиотеки выберите Обновить метаданные с режимом поиска недостающих данных. Полное пересканирование с заменой существующих данных делайте только если готовы перезаписать уже подобранные описания.

Сравнение источников метаданных для русскоязычной библиотеки

Чтобы осознанно выстроить приоритеты, полезно понимать сильные стороны каждого источника:

ИсточникРусские описанияРоссийский контентРейтинги
TheMovieDbЧастично, зависит от переводов сообществаПокрытие неполноеСобственный рейтинг TMDB
TheTVDBОграниченноСлабо представлены сериалы РФСобственный рейтинг
Кинопоиск (плагин)Да, полныеНаиболее полное покрытиеРейтинг Кинопоиска
Локальные NFO-файлыКак заполните самиПолный контрольЗадаётся вручную

Обратите внимание: точные возможности конкретного плагина — какие поля он заполняет и поддерживает ли сериалы — смотрите в описании его репозитория. Разные реализации отличаются: одни работают только с фильмами, другие умеют и эпизоды сериалов.

Типичные проблемы и их решения

Фильм не распознаётся или находится не тот тайтл. Наиболее частая причина — имя файла. Проверьте, чтобы название файла содержало название фильма и год, например: Название (2020).mkv. Год критичен для ремейков и одноимённых картин. Если файл назван по-другому, используйте ручную идентификацию: откройте тайтл в веб-интерфейсе, выберите Идентифицировать и введите название или ID Кинопоиска, если плагин поддерживает поиск по ID.

Плагин перестал работать после обновления Emby. Возможная причина — изменение внутреннего API сервера, с которым несовместима старая сборка плагина. Проверьте страницу релизов репозитория: часто выходит обновлённая версия. Если проект заброшен, придётся искать активный форк или временно откатить сервер.

⚠️ Внимание: не обновляйте сервер Emby «вслепую», если библиотека зависит от сторонних плагинов. Сначала проверьте в issue-трекере плагина, подтверждена ли совместимость с новой версией сервера.

Метаданные подгружаются, но без постеров. Проверьте, что Кинопоиск включён не только как загрузчик метаданных, но и как источник изображений — это отдельные списки в настройках библиотеки. Также убедитесь, что у сервера есть доступ в интернет и запросы не блокируются файрволом или DNS-фильтрацией.

Почему плагин может работать нестабильно

У Кинопоиска нет публичного бесплатного API в том виде, в каком он есть у TheMovieDb. Сторонние плагины либо используют неофициальные точки доступа, либо требуют токен неофициального API. Изменения на стороне сервиса могут временно ломать работу плагина — это нормальная ситуация для подобных разработок, и обычно она решается обновлением плагина.

Альтернативы плагину

Если плагин по какой-то причине не подходит, есть обходные пути. Самый надёжный — локальные метаданные: файлы .nfo и постеры, лежащие рядом с видеофайлами. Emby читает их без всяких плагинов, а сформировать такие файлы можно менеджерами медиатек вроде tinyMediaManager, которые сами умеют получать данные из разных источников.

Второй вариант — довольствоваться TheMovieDb с русским языком метаданных: в настройках библиотеки язык выбирается отдельно, и для популярных фильмов переводы там обычно есть. Проседает этот способ именно на российских сериалах и малоизвестных релизах.

Часто задаваемые вопросы

Есть ли официальный плагин Кинопоиска для Emby?

Нет, официального плагина в каталоге Emby не существует. Все доступные решения — сторонние разработки сообщества, которые распространяются через GitHub и устанавливаются вручную копированием DLL в папку плагинов сервера.

Почему после установки плагин не виден в списке?

Проверьте три вещи: файл DLL действительно лежит в папке plugins, сервер был полностью перезапущен, а в журнале сервера нет ошибок загрузки сборки. Ошибка в журнале обычно означает несовместимость версий плагина и сервера.

Как заставить Emby использовать русские названия по умолчанию?

В настройках библиотеки поднимите Кинопоиск выше остальных провайдеров в списке загрузчиков метаданных либо установите русский язык метаданных для TheMovieDb. После изменения настроек запустите обновление метаданных для нужных тайтлов.

Что делать, если фильм распознался неправильно?

Используйте функцию Идентифицировать в меню тайтла: введите правильное название и год, выберите корректный результат из списка. Чтобы проблема не повторялась, приведите имена файлов к формату «Название (год)».

Безопасно ли ставить сторонние плагины в Emby?

Риск существует, так как плагин исполняется с правами сервера. Минимизируйте его: скачивайте только из репозиториев с открытым исходным кодом, смотрите на активность проекта и отзывы в issues, избегайте анонимных сборок с файлообменников.