emby.kinopoisk.trailers

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:

• kinopoiskapiunofficial.tech
• kinopoisk.dev

Если что-то не работает - смело создавай новый issue. Я не пользуюсь плагином 24/7 - могу и не знать о сломавшейся функциональности.

Установка

• Положить dll в папку plugins.
• Настроить Медиатеку (Emby Library) использовать новый плагин (поставить галочки).
• (Рекомендуется) Получить личные токены для API.

Настройка

Параметры плагина искать в "Управление Emby Server" - Расширенное - Плагины - вкладка "Мои плагины (My Plugins)" - КиноПоиск.Трейлеры.

Использование

• Плагин создаёт папку "Трейлеры из коллекций Кинопоиска" на главном экране.
• Плагин работает как канал - при обновлении каналов, новые трейлеры, ежели появятся, будут докачены.
• Список трейлеров плагин берёт из списка выбранных коллекций в настройках плагина.
• Плагин умеет работать с двумя сайтами (kinopoiskapiunofficial.tech, kinopoisk.dev) в настройках можно выбрать откуда получать информацию. По умолчанию запросы идут на kinopoisk.dev, работая с общим API токеном (спасибо mdwitr). Его хватает на 200 запросов в день - токен быстро заканчивается. Поэтому лучше зарегистрировать свой собственный (и указать в параметрах). Для kinopoiskapiunofficial.tech также есть общий токен. Ограничение для него 500 запросов в день - тоже не бесконечный. Поэтому лучше зарегистрировать свой собственный (и указать в параметрах). Оба токена используются по-умолчанию, а значит всеми, кто скачал, но не обновил токен на свой.
• Плагин переведён на 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 (как же без них :smile: ):
    • 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 минут.

Доступные плановые задачи

• Обновляться самостоятельно (отдельная задача).
• Удалять трейлеры, скачанные с фильмов из коллекций КиноПоиска, которые перестали быть актуальными.

Требования

• Плагин тестировался на версии 4.8.8
• Собирался c .Net 7.0 для .NetStandard 2.0

TODO

• add tests to trailer functionality