Установка Lampa на Smart TV: запуск на Android, Tizen, webOS

Среди решений для Smart TV оболочка Lampa выделяется гибкостью и открытым исходным кодом клиента. Однако в Google Play ее нет: Android-клиент распространяется через GitHub (проект lampa-app/LAMPA; в его исходниках есть и отдельная сборка для RuStore), а на телевизорах LG и Samsung чаще используют обходные способы. Пользователю доступно несколько способов установки: от быстрого старта через лаунчеры-посредники до установки пакетов в режиме разработчика.

Выбор метода установки влияет на то, сможете ли вы использовать внешние плееры, сквозной вывод многоканального звука (passthrough) и автофреймрейт (AFR).

Способы установки под каждую платформу

В основе архитектуры Lampa лежит тонкий клиент Single Page Application, исполняемый в системном контейнере WebView. На открытых ОС вроде Android TV этот контейнер упакован в стандартный пакет APK, а на проприетарных телевизионных платформах Samsung Tizen и LG webOS задействуются либо специализированные веб-рантаймы, либо сторонние мультимедийные песочницы.

Перед началом настройки сопоставьте ваше устройство с таблицей ниже.

Детальное понимание того, как устроена архитектура Lampa TV, помогает заранее избежать конфликтов при распределении буфера памяти между браузерным ядром и стриминговым шлюзом.

Установка нативного APK на Android TV и Google TV

Для медиаприставок (Ugoos, Xiaomi Mi Box, Dune HD, TOX3) и ТВ с Android TV и Google TV APK-клиент — наиболее функциональный вариант (по данным репозитория, основная сборка поддерживает Android 4.1 и новее). Разбор архитектурных сборок смотрите в руководстве по установке Lampa APK на Android TV, а для платформ без сервисов Google используйте инструкцию по установке Lampa на Яндекс ТВ и Салют ТВ.

Способ 1: Быстрая установка через утилиту Downloader

Установка без флешек и внешних накопителей:

1. Установите бесплатное приложение Downloader by AFTVnews из Google Play Store на телевизоре.
2. В меню ТВ Безопасность и ограничения -> Неизвестные источники предоставьте Downloader разрешение на установку (название пункта зависит от прошивки).
3. В поле URL введите прямую ссылку на последний релиз: https://github.com/lampa-app/LAMPA/releases/latest/download/app-lite-release.apk и нажмите Go. Короткие коды Downloader создаются пользователями сервиса AFTVnews и могут вести на посторонние файлы, поэтому перед вводом кода проверяйте, куда он ведет (справочник: коды Downloader).
4. Дождитесь загрузки APK и нажмите Install. Подробнее — в руководстве по установке Lampa через утилиту Downloader.
5. При первом запуске клиент попросит указать адрес, с которого загружать Lampa (например, lampa.mx).

Способ 2: Установка через ADB по локальной сети

Если на приставке заблокирован магазин приложений или отсутствует штатный веб-браузер, развертывание выполняется с персонального компьютера через мост Android Debug Bridge:

# Активация сетевой отладки и подключение к IP-адресу ТВ-бокса
adb connect 192.168.1.120:5555

# Установка пакета с перезаписью (-r) и разрешением понижения версии (-d)
adb install -r -d app-lite-release.apk

Перед adb connect включите на приставке режим разработчика и отладку по сети (на некоторых прошивках — «Отладка по USB» с подключением по Wi-Fi). Имя пакета приложения — top.rootu.lampa; дополнительные разрешения выдавать вручную не требуется. Если в вашей прошивке есть настройки оптимизации энергопотребления, исключите из нее Lampa.

Запуск через Media Station X на Samsung Tizen и LG webOS

Владельцам телевизоров Samsung и LG, не желающим активировать режим разработчика и подключать компьютер, доступен запуск через кроссплатформенное приложение Media Station X (MSX). Оно доступно в магазинах приложений LG и Samsung (подробный разбор шлюзов смотрите в руководстве по настройке Media Station X).

Порядок подключения:

1. Откройте штатный магазин приложений на ТВ, найдите в поиске Media Station X и установите программу.
2. Запустите MSX, на стартовом экране с помощью пульта ДУ выберите пункт Settings (иконка шестеренки).
3. Перейдите в раздел Start Parameter -> Setup.
4. В появившемся поле экранной клавиатуры введите стартовый адрес:
   • собственный сервер: официальный README Lampa описывает размещение файла msx/start.json на своем хостинге, а сервер Lampac отдает его по адресу IP_СЕРВЕРА:9118/msx/start.json;
   • сторонние порталы-лаунчеры: msxplayer.ru (или v4.msxplayer.ru), wals09.github.io (портал W.A.L.S). Их поддерживают энтузиасты, а набор приложений в них может меняться.
5. Нажмите кнопку с галочкой на виртуальной клавиатуре и подтвердите перезагрузку интерфейса клавишей Yes.
6. В появившемся лаунчере выберите ярлык Lampa (если портал его предоставляет) и подтвердите запуск.

Если стартовый адрес становится недоступен, смотрите варианты в статье об актуальных рабочих зеркалах Lampa.

Автономная установка пакетов IPK и WGT через Developer Mode

Запуск через MSX зависит от доступности стороннего хостинга. Если вы хотите превратить Lampa в постоянное системное приложение, не зависящее от сторонних доменов, установите виджет напрямую во внутреннюю flash-память телевизора.

Установка на LG webOS (пакет IPK)

1. Зарегистрируйте бесплатный аккаунт на портале LG Developer.
2. Установите приложение Developer Mode из LG Content Store, авторизуйтесь и переведите тумблер Dev Mode Status в положение ON. Телевизор выполнит перезагрузку.
3. Скачайте на ПК программу webOS Dev Manager (доступна для Windows, macOS и Linux).
4. Подключитесь к IP-адресу ТВ по порту 9922, используя ключ аутентификации из приложения Developer Mode.
5. Нажмите кнопку Install и укажите IPK-пакет Lampa (например, Lampac отдает его по адресу IP_СЕРВЕРА:9118/lg.ipk). Приложение появится на главном экране Home Dashboard как полноценная плитка. Подробную пошаговую инструкцию с настройкой Homebrew Channel смотрите в материале установка Lampa на LG webOS.

Установка на Samsung Tizen (пакет WGT)

1. Активируйте Developer Mode на ТВ: в меню приложений наберите на пульте последовательность 1-2-3-4-5, включите режим разработки и укажите локальный IP-адрес вашего ПК. Перезагрузите ТВ долгим удержанием кнопки питания.
2. Установите Tizen Studio на компьютер, сгенерируйте сертификат автора Samsung Certificate.
3. Подключитесь к устройству через утилиту командной строки SDB:

# Подключение к порту управления Tizen
sdb connect 192.168.1.135:26101

# Проверка статуса сопряжения
sdb devices

# Установка подписанного виджета в постоянную память
sdb install lampa.wgt

Подробное пошаговое руководство по созданию профилей сертификатов и сборке виджетов смотрите в отдельной статье установка Lampa на Samsung Tizen.

Первичная настройка и подключение видеопотока

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

Ниже кратко о главном, а все разделы настроек по порядку разобраны в отдельной инструкции по настройке Lampa с нуля.

1. Синхронизация через CUB: перейдите в Настройки -> Синхронизация, включите синхронизацию и нажмите Выполнить вход — на экране появятся код и QR-код. Отсканируйте QR-код смартфоном или откройте на телефоне сайт CUB (в актуальной версии — cub.best/activate, для российского региона cub.black/activate) и подтвердите вход. Это сохранит историю просмотров, закладки и тайм-коды.
2. Подключение TorrServer: в разделе Настройки -> TorrServer в поле Основная ссылка укажите адрес локального или удаленного сервера (например, http://192.168.1.100:8090). Подробные инструкции по конфигурированию параметров буфера памяти описаны в руководстве по настройке сервера TorrServer Matrix. Если вы хотите отказаться от использования ПК в пользу роутера с накопителем, следуйте инструкции по развертыванию TorrServer на домашнем роутере Keenetic.
3. Активация каталогов контента: чтобы подключить проверенные онлайн-балансеры для Lampa для прямого стриминга без локального сервера, воспользуйтесь нашим инструментом интерактивный конфигуратор плагинов, который формирует ссылки на скрипты расширений.

Что делать, если Lampa не устанавливается или вылетает

В процессе установки могут возникнуть аппаратные или сетевые сбои. Вот готовые решения для частых неполадок:

• Ошибка «Не удалось подключиться к серверу»: сменился локальный IP-адрес хоста с движком TorrServer либо порт 8090 заблокирован брандмауэром. Полный протокол проверки описан в статье решение ошибки подключения к серверу в Lampa.
• Ошибка «Сбой синтаксического анализа пакета» на Android: обычно файл скачался не полностью или версия Android ниже минимальной для выбранной сборки (например, сборка для RuStore требует Android 7.0+). Скачайте основную сборку app-lite-release.apk заново с GitHub.
• Белый экран при запуске через MSX: попробуйте очистить данные или переустановить MSX и повторно ввести стартовый адрес; убедитесь, что сам адрес доступен (см. статью об ошибке подключения).
• Исчезновение виджета на webOS через двое суток: сессия Developer Mode ограничена 50 часами. Продлевайте ее в приложении Developer Mode до истечения таймера.

Чек-лист перед запуском фильма:

• Установлена актуальная версия Lampa
• Настроен статический локальный IP-адрес для сервера TorrServer (и при необходимости для ТВ)
• Проверена скорость домашней сети Wi-Fi: для тяжелых 4K-релизов предпочтителен диапазон 5 ГГц или кабель
• Выполнен вход в аккаунт CUB и сделан бэкап настроек
• Подключен TorrServer Matrix с подходящим размером кеша