TorBox Lampa Plugin

Плагин для Lampa, который добавляет просмотр торрентов через TorBox.app прямо из карточки фильма/сериала.

Текущая версия: 51.2.0

Установка

1. Откройте Lampa: Настройки → Плагины → Добавить плагин.
2. Вставьте URL:

   https://slonce70.github.io/addon_lampa_torbox/torbox-lampa-plugin.js
   

3. Нажмите Enter.

Настройка

Настройки → TorBox:

• API key: ключ TorBox.
• CORS proxy URL: URL прокси (через него идут все запросы).
• Debug mode: включает подробные логи в консоль.

Дополнительно:

• Tracking retries (3–120) и Tracking interval (3000–60000 ms): опрос статуса торрента.
• Video extensions: список расширений для отбора файлов серий.
• Default: cached only, Quality priority, Preferred audio languages, Preferred video codecs, Exclude trackers.
• Prefer permanent link: пробует requestdl&redirect=true с автоматическим fallback.
• Auto-pick file (movies): выбор лучшего файла для фильмов (крупнейший, без sample/trailer).
• Debug overlay и Export diagnostics.

Управление с пульта (TV)

• Навигация построена на стандартных правилах Lampa: элементы с .selector и события hover:focus/hover:enter.
• Right из списка торрентов сразу открывает фильтры.
• Переключатель ⚡/☁️ встроен в панель фильтров и не должен ломать фокус.

Тестирование

Есть validate, unit и минимальный e2e smoke (Playwright, Chromium).

Быстрые проверки (локально)

node scripts/validate.js
node --test tests/unit/torbox-pure.test.js
npx --yes playwright install chromium
npx --yes playwright test tests/e2e/focus-smoke.spec.js --project=chromium

Ручной чек-лист на TV

• Открыть карточку фильма/сериала -> зайти в TorBox.
• Пока идет загрузка: Right/Left/Up/Down/Back не ломают экран.
• Список торрентов: Up/Down листает, фокус не пропадает.
• Right из списка -> фильтры открываются сразу.
• При наличии «Продолжить просмотр»: Up с первого элемента списка -> «Продолжить просмотр», затем Up -> поиск/фильтры.
• Переключатель ⚡/☁️: OK переключает режим, список обновляется, фокус не скачет.
• Торрент с несколькими файлами: вход в эпизоды -> навигация -> OK -> запуск -> Back -> возврат.

Диагностика

• Включи Debug mode и смотри Console (сообщения с префиксом [TorBox]).
• Если на ТВ “фильтр не открывается”, почти всегда причина в фокусе (не на той кнопке) или в том, что элемент не попал в коллекцию навигации.

Changelog

51.2.0

• P0 security hardening: закрыты критичные HTML-инъекции (Tracker, file.name, filter.chosen, пустые состояния и related paths).
• Ошибки API теперь сохраняют detail/message для 4xx/5xx, чтобы диагностика была предметной.
• P1 compatibility: регистрация плагина переведена на корректный Manifest.plugins = manifest (+ fallback), добавлен запуск из меню плагинов (onContextMenu/onContextLauch).
• requestdl стратегия: опция Prefer permanent link (redirect=true) с безопасным fallback на классический режим.
• Добавлены пользовательские предпочтения: дефолт cached-only, приоритет качества/аудио/кодека, исключение трекеров.
• Улучшен выбор файла: запоминание выбранного файла по торренту, авто-эвристика для фильмов (largest + ignore sample/trailer).
• Наблюдаемость: Debug overlay, телеметрия последних ошибок/логов, экспорт JSON-диагностики в буфер.
• Тесты: unit (pure helpers + security guards) и e2e smoke (focus navigation in real browser).

51.1.6

• Right из списка торрентов теперь сразу открывает фильтры (без промежуточного наведения на кнопку).
• При наличии «Продолжить просмотр»: Up с первого элемента списка сначала переводит фокус на панель «Продолжить просмотр», а уже потом на поиск/фильтры (логический порядок сверху вниз).
• Отметка просмотренной серии стала надёжнее: серия помечается как просмотренная сразу после успешного старта плеера (даже если callback плеера в конкретной сборке не срабатывает).

51.1.5

• Исправлен сценарий с появлением «Продолжить просмотр»: фокус больше не “проскальзывает” мимо панели поиска/фильтров и не уводит навигацию наверх.
• Навигация стала стабильнее: по умолчанию фокус стартует со списка, Up ведёт в фильтры/поиск, Down из фильтров ведёт в «Продолжить просмотр» (если есть).

51.1.4

• Исправлена навигация по фильтрам на ТВ: фокус с пульта попадает на реальную кнопку filter--filter, а не на кастомный переключатель.
• Панель «Продолжить просмотр» добавляется/удаляется из навигационной коллекции, чтобы фокус не «пропускал» элемент.

51.1.3

• Исправлена навигация: первый переход вправо фокусирует панель фильтров, вверх с первого элемента списка переносит к фильтрам и поиску без дополнительных нажатий.
• Переключатель «⚡/☁️» интегрирован в панель фильтров и не перехватывает управление.

51.1.2

• Добавлена защита try/catch вокруг инициализации, запись стека ошибки в localStorage и нотификация в Lampa, обновление версии.

51.1.1

• Исправлен критический регресс, мешавший загрузке плагина (инициализация контроллеров фокуса вызывалась до определения функций).

51.1.0

• Введена табличная схема фокуса с учётом панели «Продолжить просмотр» и переключателя кеша.
• Добавлен безопасный откат UI при отменённом/несостающемся воспроизведении, отметка серий выполняется только после старта.
• Исключены «сырые» данные из кеша и состояния, списки просмотренных серий ограничены 250 записями, снапшоты урезаются по размеру.
• Появились настройки количества повторов трекинга, интервала опроса и списка видео-расширений; данные нормализуются автоматически.
• Генератор уточнений поиска учитывает альтернативные названия, годы, сезоны, ключевые слова и ID, подсказки снабжены метками категорий.