Fetches metadata from kinopoisk.ru. This site is popular in the Russian-speaking community and contains almost no English-language information so further description will be in Russian.
Плагин для Emby для загрузки метаданных фильмов, сериалов с сайта kinopoisk.ru используя сторонние API:
Если что-то не работает - смело создавай новый issue. Я не пользуюсь плагином 24/7 - могу и не знать о сломавшейся функциональности.
Альтернатива для Jellyfin - LinFor/jellyfin-plugin-kinopoisk
- Спасибо svyaznoy362 за тестирования версий.
- Спасибо azharkov78 за тестирования функциональности, связанной с роликами к CinemaMode и каналом.
- Спасибо Sanchous98 за тестирования совместимости с Android устройствами.
- Положить dll в папку plugins.
- Настроить Медиатеку (Emby Library) использовать новый плагин (поставить галочки).
- (Рекомендуется) Получить личные токены для API.
Параметры плагина искать в "Управление Emby Server" - Расширенное - Плагины - вкладка "Мои плагины (My Plugins)" - КиноПоиск.
- Плагин умеет работать с двумя сайтами (kinopoiskapiunofficial.tech, kinopoisk.dev) в настройках можно выбрать откуда получать информацию. По умолчанию запросы идут на kinopoisk.dev, работая с общим API токеном (спасибо mdwitr). Его хватает на 200 запросов в день - токен быстро заканчивается. Поэтому лучше зарегистрировать свой собственный (и указать в параметрах). Для kinopoiskapiunofficial.tech также есть общий токен. Ограничение для него 500 запросов в день - тоже не бесконечный. Поэтому лучше зарегистрировать свой собственный (и указать в параметрах). Оба токена используются по-умолчанию, а значит всеми, кто скачал, но не обновил токен на свой.
- Плагин умеет подхватывать ID КиноПоиска в имени файла по шаблону "<текст>kp<ID КиноПоиска><текст без цифр><текст>" или "<текст>kp-<ID КиноПоиска><текст без цифр><текст>" и использовать его для поиска в базе. Также умеет искать по названию фильма (если сможет название распознать из имени файла).
- Плагин умеет автоматически создавать коллекции фильмов основываясь на данных сиквелов и приквелов КиноПоиска. Функция отключаемая в настройках плагина. Работает только для kinopoisk.dev - API предоставляет эти данные.
- Плагин переведён на 3 языка: английский, русский, украинский. Язык зависит от настроек языка отображения.
- Плагин умеет создавать канал, содержащий трейлеры фильмов выбранных коллекций КиноПоиска и при помощи CinemaMode (CinemaIntro) демонстрировать их перед фильмом. Для этого:
- в настройках плагина надо указать куда скачивать трейлеры. Поле "Куда скачивать трейлеры". (обязательно). Путь должен быть локальным, а-ля /mnt/library или c:\library, даже если фактически эта папка лежит где-то в сети.
- в настройках параметр максимальной длины ролика. По умолчанию 5 минут. Если трейлер будет длиннее - он не будет добавлен
- (рекомендуется) указать ключ для UserAgent API с сайта apilayer.com. Выбрать там https://apilayer.com/marketplace/user_agent-api, бесплатно даёт 10 000 запросов в месяц. Без него тоже будет работать, но шанс, что стороннее API заблокирует запрос выше.
- указать желаемое качество роликов (480, 720, 1080). По умолчанию 480.
- выбрать коллекции, трейлеры фильмов которых интересуют.
- запустить задачу "Обновить интернет каналы" - она и будет скачивать ролики.
- подождать (займёт время - чтоб сайт по подготовке ссылок не блокировал, я поставил ожидание 5-15 секунд между скачиванием каждого ролика, плюс временное ограничение на скачивание одного ролика в 5 минут (необходимо, если скачивание проходит неудачно)).
- скачанные ролики будут доступны на главном экране под названием "Трейлеры из коллекций КиноПоиска" (или похожее по смыслу на другом языке).
- никаких настроек CinemaMode делать не надо - плагин работает на подобии плагина Trailers - поставляет intros в систему.
- если задача по обновлению каналов отменена, в канале показывается то, что было скачано.
- скачивать умеет с youtube и виджетов КиноПоиска
- поддерживает и kinopoiskapiunofficial.tech, и kinopoisk.dev
- если ролик уже был скачан, плагин попытается его найти. Найдёт - повторно качать не будет.
- нюансы для роликов на youtube (как же без них 😄 ):
- https://apilayer.com доступен из России без VPN
- для скачивания роликов используются сайты https://tomp3.cc и https://www.y2mate.com
- https://tomp3.cc доступен из России без VPN
- https://www.y2mate.com НЕ доступен из России без VPN
- https://www.y2mate.com иногда требует доказать, что скачивает человек (тестировщик azharkov78 с этим столкнулся)
- часть ссылок "битая" - такого ролика на youtube больше нет, канал был удалён и т.п. Плагин будет запоминать и не пытаться скачать ещё раз.
- часть ссылок сайты конвертации не могут обработать.
- есть таймауты на скачивание одного ролика - 5 минут.
- Создавать коллекции КиноПоиска из фильмов/сериалов в медиатеке (отдельная задача). Чтоб начать использовать эту задачу, в настройках плагина надо выбрать какие коллекции создавать.
- Добавлять ID КиноПоиска по ID IMDB или TMDB (отдельная задача). Для kinopoiskapiunofficial.tech - только по IMDB
- Обновляться самостоятельно (отдельная задача).
- Удалять трейлеры, скачанные с фильмов из коллекций КиноПоиска, которые перестали быть актуальными.
Поддерживаются:
- Фильмы
- Сериалы
- Актёры
На данный момент грузятся:
- Жанры
- Название
- Оригинальное название (на английском)
- Рейтинги (оценки фильма и рейтинг MPAA)
- Слоган
- Дата выхода фильма
- Описание
- Постеры и задники
- Актёры
- Названия эпизодов
- Дата выхода эпизодов
- Студии
- Трейлеры (только youtube - ограничения emby)
- Факты о фильме/сериале/персоне (встраивается в описание)
- Плагин тестировался на версии 4.8.8
- Собирался c .Net 7.0 для .NetStandard 2.0
- Поддерживает Emby соответствующих версий на Android устройствах (спасибо Sanchous98)
- add tests to trailer functionality