Перейти к содержимому

Плагин Trakt в Lampa: настройка скробблинга и истории серий

Как настроить плагин Trakt для Lampa: интеграция аккаунта, авторизация через код активации, автоматический скробблинг и перенос истории просмотров.

6 мин чтения
Плагин Trakt в Lampa: настройка скробблинга и истории серий

Trakt подключается к Lampa сторонним плагином: добавьте в «Настройки» → «Расширения» адрес https://lampame.github.io/main/trakttv.js, перезапустите Lampa и привяжите устройство кодом на trakt.tv/activate. Встроенная экосистема учетных записей CUB и так синхронизирует закладки, историю и тайм-коды между устройствами с Lampa, но эти данные живут только внутри экосистемы Lampa и зависят от лимитов аккаунта.

Если вы ведете историю просмотров в сервисе Trakt.tv (или пользуетесь им и в других приложениях), его можно подключить к Lampa через сторонний JS-плагин TraktTV из сборника LME (это не официальный плагин Trakt). Сервис фиксирует просмотренные серии и фильмы (Scrobbling) и формирует ленту «Up Next» (что смотреть дальше), которую плагин выводит в Lampa.

Возможности и архитектура расширения Trakt для Lampa

Расширение Trakt представляет собой модульный клиент к REST API v2 сервиса api.trakt.tv. Модуль подключается в рантайм Lampa через стандартный механизм расширений и взаимодействует с внутренними событиями встроенного HTML5-видеоплеера и внешних декодеров.

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

  1. Автоматический скробблинг: при запуске воспроизведения плагин отправляет событие scrobble/start, во время просмотра периодически передает прогресс (интервал настраивается), а при остановке отправляет итоговый прогресс. Trakt засчитывает просмотр, если прогресс в запросе scrobble/stop составляет 80% и больше; плагин дополнительно использует собственный «Порог просмотра».
  2. Лента Up Next на главном экране: оболочка автоматически запрашивает следующий не просмотренный эпизод для всех сериалов из вашей истории. Вам больше не нужно вспоминать, на каком сезоне и серии вы остановились.
  3. Watchlist и личные списки Trakt: доступ к вашим закладкам Trakt без привязки к конкретной операционной системе (Android TV, Tizen или webOS).
  4. Индивидуальный календарь премьер: список дат выхода новых серий именно тех сериалов, которые добавлены в ваш профиль.

Если вы активно используете каталог плагинов для Lampa, учтите: плагин Trakt сопоставляет карточки Lampa с записями Trakt по идентификаторам TMDB ID и IMDb ID, поэтому источник видео (онлайн или торрент) для него не важен.

Установка плагина Trakt в медиаоболочку

Для подключения используется скрипт из репозитория сборника плагинов LME (lampame/main на GitHub). Установка выполняется в несколько стандартных шагов:

  1. Запустите Lampa на вашем телевизоре или ТВ-боксе.
  2. Перейдите в раздел Настройки (иконка шестеренки) -> Расширения.
  3. Нажмите кнопку Добавить плагин.
  4. В появившемся поле ввода URL с помощью экранной клавиатуры укажите рабочий адрес скрипта:
https://lampame.github.io/main/trakttv.js
  1. Нажмите клавишу ввода и подтвердите добавление.
  2. Выйдите в главное меню и полностью перезапустите Lampa (на Android TV — через принудительное закрытие в диспетчере задач, на Smart TV — перезапуском приложения).

После повторного запуска в настройках Lampa появится раздел Trakt.TV с параметрами плагина, а в интерфейсе — разделы Trakt (набор зависит от версии плагина).

Авторизация через протокол OAuth Device Code

Плагин не требует небезопасного ввода пароля учетной записи на экране телевизора. Сопряжение выполняется по отраслевому стандарту RFC 8628 (OAuth 2.0 Device Authorization Grant):

  1. Откройте Настройки -> Trakt.TV.
  2. Выберите пункт Авторизация Trakt.
  3. На экране появится окно со ссылкой trakt.tv/activate и кодом устройства (у Trakt это обычно 8 символов — цифры и латинские буквы).
  4. На смартфоне или компьютере откройте браузер, войдите в свой профиль Trakt и перейдите по адресу trakt.tv/activate.
  5. Введите код, отображаемый на экране телевизора, и подтвердите доступ кнопкой Authorize.
  6. Плагин периодически опрашивает Trakt и после подтверждения получает токены доступа (access_token и refresh_token).

Токены сохраняются в локальном хранилище (localStorage) устройства. С 20 марта 2025 года Trakt выдает access_token со сроком жизни 24 часа (раньше — 3 месяца), поэтому плагин регулярно обновляет его через refresh_token. Если обновление не удалось (например, доступ отозван на сайте Trakt), авторизацию придется пройти заново.

Тонкая настройка скробблинга и списков

После авторизации проверьте параметры скробблинга (названия — по версии плагина на момент написания):

Учтите лимиты бесплатного аккаунта Trakt. С начала 2025 года, по данным alternativeto.net, Watchlist и коллекция в бесплатном аккаунте ограничены 100 элементами, личных списков можно завести два, по 100 элементов в каждом; расширенные возможности доступны в VIP (тогда же цена VIP выросла с 30 до 60 долларов в год). Trakt пересматривал лимиты и на 2026 год (тема «Updating Trakt Limits for 2026» на форуме Trakt), поэтому перед переносом большой истории сверьтесь с условиями на support.trakt.tv.

  1. Включить отслеживание просмотра: по умолчанию выключено. Включите, чтобы плагин автоматически отмечал просмотренные эпизоды и добавлял сериалы в «Смотрю».
  2. Интервал скробблинга: как часто отправлять прогресс во время воспроизведения — 30, 60, 90 (по умолчанию) или 120 секунд.
  3. Порог просмотра: минимальный процент просмотра для отметки эпизода — от 50 до 100%, по умолчанию 90%. Если вы часто выключаете плеер на финальных титрах, снизьте значение до 80–85%: ниже 80% сам Trakt все равно не засчитает просмотр при остановке.
  4. Офлайн-очередь: по умолчанию включена — скробблинг сохраняется при отсутствии сети и отправляется позже.
  5. Источник: скрывать просмотренное: позволяет убрать уже просмотренное из подборок Trakt.

Специфика работы с внешними видеоплеерами

Если во встроенном плеере Lampa отслеживание прогресса работает нативно через события HTML5 Media API, то при перенаправлении потока во внешние плееры Vimu, Just Player или VLC процесс синхронизации требует внимания:

  • Внешние плееры на Android: APK-клиент Lampa получает результат воспроизведения от ряда плееров (в исходном коде есть обработка Vimu по его Player API, а также Just Player, MX Player и mpv) и сохраняет позицию в истории просмотра Lampa. Плагин следит за этими обновлениями, поэтому скробблинг работает, только если выбранный плеер действительно возвращает позицию.
  • Встроенный плеер Lampa: на Tizen и webOS это основной вариант, и события воспроизведения плагин получает напрямую.
  • Сбои синхронизации при обрыве сети: при включенной «Офлайн-очереди» недоставленные события сохраняются в локальном хранилище Lampa и отправляются позже.

Для более точного выбора аудиодорожек и субтитров перед началом сеанса используйте связку с плагином Tracks-MediaInfo, который позволяет заранее оценить параметры медиаконтейнера.

Устранение неполадок при работе с Trakt

  1. Ошибка 401 Unauthorized при попытке скробблинга: токен авторизации устарел либо был отозван в настройках безопасности Trakt. Зайдите в настройки плагина, выйдите из аккаунта и повторите процедуру сопряжения через код на trakt.tv/activate.
  2. Серии не отмечаются автоматически: убедитесь, что включено «Отслеживание просмотра», и проверьте «Порог просмотра». Если просмотр заканчивается раньше порога (например, вы выключаете плеер на титрах), отметка не ставится — снизьте порог до 80–85%.
  3. Бесконечная загрузка окна с кодом активации: телевизор не может достучаться до api.trakt.tv. Проверьте, открывается ли trakt.tv с другого устройства в той же сети, и DNS на телевизоре (например, 1.1.1.1).

Чек-лист готовности интеграции Trakt в Lampa

  • Плагин trakttv.js добавлен в меню расширений Lampa и успешно инициализирован.
  • Устройство привязано к аккаунту Trakt через ввод кода на trakt.tv/activate.
  • В настройках плагина включено «Отслеживание просмотра» и выбран подходящий «Порог просмотра».
  • В интерфейсе появились разделы Trakt (Up Next, Watchlist).
  • При просмотре через внешний плеер проверено, что прогресс сохраняется в истории Lampa.

Источники

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

Нужен ли VIP-аккаунт Trakt для плагина в Lampa?

Для авторизации и скробблинга VIP не нужен. Но у бесплатного аккаунта Trakt с 2025 года есть лимиты: по данным alternativeto.net (февраль 2025), Watchlist и коллекция — до 100 элементов, личных списков — два по 100 элементов. Если переносите большую историю, проверьте актуальные условия на support.trakt.tv.

Почему серии не отмечаются при просмотре во внешнем плеере?

Плагин видит прогресс только тогда, когда внешний плеер вернул позицию воспроизведения в Lampa. APK-клиент Lampa умеет получать ее от Vimu, Just Player, MX Player и mpv; другие плееры позицию могут не возвращать. Проверьте также «Порог просмотра»: если вы выключаете плеер на титрах раньше порога, отметки не будет.

Бесплатный тест 24 часа (без карты) Скидка 15% СБП +20% бонус Оплата из ЕС и РФ
Шаровоз: 2 000+ каналов и 4K кинозалы

Официальный премиум-пакет от Шаровоз: 296 Кинозалов (BCU и 4K новинки), 116 каналов РФ, 92 Спортивных (Матч Премьер 50fps) и архив за 6 дней.

Оплата:⚡️СБП QR (РФ)+20%💳Карты РФ (МИР)🇪🇺Карты ЕС / Зарубеж💎USDT / Crypto🌐PayPal / FreeKassa
Единый тариф
3$/ месяц
~240 ₽ • 0 ₽ за 24ч теста
Тест 24ч без оплаты →
Интерактив
Мастер

Готовые плагины под вашу задачу

Ответьте на 3 вопроса о вашем ТВ, и мастер подберет проверенный набор скриптов.

  • Онлайн-видео (балансеры)Без P2P
  • 4K торренты (TorrServer)В стриме
  • Зеркала CUB и плагиныАктуально
Запустить конфигуратор

Теги

Опубликовано:
Обновлено:
Понравилось руководство? Поделитесь:
В Telegram
Илья Новиков
Автор материала
Илья Новиков
Инженер по ремонту медиаприставок, ноутбуков, телефонов и ПК

Ремонтирует и настраивает медиаприставки, ноутбуки, телефоны и компьютеры в Уссурийске. Ведёт lampa.help: редактирует материалы и сверяет команды, адреса и настройки с исходным кодом Lampa, TorrServer и Lampac и с документацией производителей.