Установка сторонних приложений на телевизоры LG на платформе webOS требует активации режима разработчика, так как официальный магазин LG Content Store не поддерживает загрузку пакетов из внешних источников. Процедура отличается от привычной установки APK на Android: здесь используется формат .ipk и утилита командной строки ares-cli из официального SDK. Действия выполняются по локальной сети, поэтому телевизор и компьютер должны находиться в одной подсети.
Наличие аккаунта разработчика на портале LG Developer является обязательным условием — без принятия пользовательского соглашения и привязки устройства пункт меню «Режим разработчика» останется неактивным. Стоит учитывать, что интерфейс приложения «Developer Mode» и набор доступных настроек могут отличаться на версиях webOS 3.0, 4.0, 5.0, 6.0, 22, 23 и 24, поэтому скриншоты из старых инструкций часто вводят в заблуждение.
Подготовка аккаунта и регистрация телевизора
Первым делом перейдите на сайт developer.lge.com и создайте учетную запись, если её ещё нет. После подтверждения почты войдите в личный кабинет и примите условия соглашения Developer Site Terms of Use — без этого шага сервер выдачи ключей не будет доступен. В разделе «My Products» добавьте новое устройство, указав Device ID (он отображается в приложении Developer Mode на телевизоре после первого запуска) и выбрав профиль webOS TV.
Система сгенерирует уникальный ключ и IP-адрес сервера ключей (Key Server), которые понадобятся для настройки телевизора. Сохраните эти данные в текстовом файле — их придётся вводить вручную с пульта. Обратите внимание: один аккаунт разработчика позволяет зарегистрировать до 10 устройств, что достаточно для домашнего использования и тестирования.
Активация режима разработчика на телевизоре
Откройте магазин LG Content Store, в строке поиска начните вводить «Developer Mode» — приложение обычно находится в категории «Приложения» → «Другие». Установите его и запустите. При первом запуске отобразится Device ID и поля для ввода Key Server IP и Key Server Port (обычно 9991). Введите данные из личного кабинета разработчика, установите переключатель «Unknown Sources» (Неизвестные источники) в положение «On» и нажмите «Apply».
Телевизор перезагрузится для применения настроек. После включения снова зайдите в Developer Mode — статус должен показать «Connected to Key Server». Если соединение не установлено, проверьте, что брандмауэр на компьютере не блокирует входящие подключения на порту 9991, и что телевизор не использует VPN или DNS-фильтры, перенаправляющие трафик.
☑️ Чек-лист
Установка пакета.ipk через ares-cli (основной метод)
Для работы с утилитой ares-cli на компьютере должен быть установлен Node.js (рекомендуется LTS-версия). Откройте терминал (PowerShell, cmd или bash) и выполните установку пакета глобально: npm install -g @webosbrew/ares-cli. Комmunity-версия от WebOS Brew поддерживает современные версии webOS лучше, чем устаревший официальный SDK.
# Добавление телевизора в список устройств
ares-setup-device --name mytv --ip 192.168.1.50
Установка приложения (путь к.ipk файлу)
ares-install --device mytv /path/to/app.ipk
Запуск установленного приложения
ares-launch --device mytv com.example.app
Команда ares-setup-device инициирует сопряжение: на экране телевизора появится запрос на подтверждение подключения с отображением кода PIN. Введите его в терминале в течение 60 секунд. После успешной авторизации устройство сохранится в конфигурации, и для последующих установок достаточно использовать только флаг --device mytv.
Решение проблем с подключением ares-cli
Если терминал выдаёт"Connection refused" или"Timeout", проверьте: 1) IP-адрес телевизора не изменился после перезагрузки роутера (лучше зафиксировать статический DHCP-). 2) Порт 9991 открыт для входящих соединений на ПК (Windows Defender / iptables). 3) На телевизоре в Developer Mode включён пункт"Devmode Service" (на webOS 22+). 4) Используется IPv4-адрес, а не IPv6 (ares-cli работает нестабильно с IPv6).
Альтернативные способы: Homebrew Channel и веб-установка
Проект Homebrew Channel (HBC) от сообщества WebOS Brew позволяет устанавливать домашние приложения без постоянного подключения компьютера. После однократной установки канала через ares-install на телевизоре появляется лаунчер с каталогом открытых приложений (YouTube Vanced, Jellyfin, Kodi, браузеры с расширениями и др.), которые обновляются прямо с телевизора.
Существует также веб-интерфейс webOS Homebrew App Store, доступный по адресу http:// после установки HBC. Он позволяет загружать .ipk файлы прямо из браузера телефона или ПК. Этот метод удобен для разовых установок, но требует включённого режима разработчика и работающего сервиса HBC в фоне.
Используйте Homebrew Channel для комфортного управления сторонним софтом: он добавляет автообновления, категории и описания приложений, которых нет в официальном сторе.
Сравнение возможностей по версиям webOS
Политика безопасности и состав предустановленных инструментов менялись с каждым крупным релизом. Ниже приведена сводная таблица ключевых отличий, актуальная на момент выхода версий прошивок. Точный набор функций всегда нужно сверять с документацией к конкретной модели, так как региональные прошивки могут иметь ограничения.
| Версия webOS | Годы выпуска | Developer Mode App | Unknown Sources | Примечания |
|---|---|---|---|---|
| webOS 1.0 — 3.5 | 2014–2018 | Отдельное приложение в сторе | Есть | Требует старого SDK (webOS TV SDK 1.x) |
| webOS 4.0 — 5.0 | 2019–2020 | Встроено в настройки (Ctrl+F8) | Есть | Поддержка ares-cli 1.x, нет HBC |
| webOS 6.0 (webOS TV 6.0) | 2021 | Приложение Developer Mode | Есть | Появилась поддержка Docker-контейнеров |
| webOS 22 / 23 | 2022–2023 | Приложение Developer Mode | Есть (в Devmode Service) | Рекомендуется @webosbrew/ares-cli |
| webOS 24 | 2026 | Приложение Developer Mode | Есть | Усиленная проверка подписи пакетов |
Типичные ошибки и их устранение
Ошибка INSTALL_FAILED_INVALID_PACKAGE означает, что файл .ipk повреждён, имеет неверную структуру манифеста appinfo.json или собран под несовместимую архитектуру (например, x86 вместо arm64). Проверьте архив: это должен быть валидный tar.gz с папками app/, icon.png и корневым appinfo.json.
Если установка проходит успешно, но иконка не появляется в лаунчере, проверьте поле visible: true в appinfo.json. Некоторые портированные приложения имеют visible: false и запускаются только через ares-launch или голосовые команды. Также на webOS 23/24 политики безопасности могут блокировать запуск неподписанных бинарников внутри пакета.
⚠️ Внимание: установка приложений не из официального магазина отключает автоматические обновления безопасности для этих пакетов. Вы несете ответственность за проверку исходного кода и разрешения, запрашиваемые приложением.
⚠️ Внимание: сброс телевизора к заводским настройкам или обновление системного ПО (OTA) полностью удаляет режим разработчика и все сторонние приложения. Процедуру активации придётся повторять заново.
⚠️ Внимание: некоторые банковские приложения и сервисы DRM (Netflix 4K, Disney+) могут перестать работать после включения Developer Mode из-за срабатывания механизмов защиты от рута/модификаций.
Безопасность, ограничения и откат изменений
Режим разработчика не дает полного рут-доступа к файловой системе — он лишь разрешает установку неподписанных IPK-пакетов и доступ по протоколу SSH (на старых версиях) или через ares-shell. Доступ к системным разделам /, /usr остаётся закрытым для записи. Это означает, что «кирпич» устройства программным путём маловероятен, но нестабильное приложение может зависнуть интерфейс, требующий перезагрузки из розетки.
Для возврата к исходному состоянию достаточно зайти в приложение Developer Mode и переключить главный тумблер в положение «Off», затем подтвердить деактивацию. Телевизор перезагрузится, все сторонние приложения будут удалены, а доступ по ares-cli закрыт. Учётная запись разработчика на портале LG при этом не удаляется — устройство можно зарегистрировать снова в любой момент.
Главное правило: включайте режим разработчика только на время установки или отладки, а в бытовом режиме держите его выключенным для сохранения работы DRM-сервисов и безопасности.
FAQ: Часто задаваемые вопросы
Можно ли установить APK от Android на webOS?
Нет, webOS использует собственный формат пакетов .ipk и движок на базе Linux/Qt/QML, несовместимый с Android Runtime. Запуск APK возможен только через эмуляторы (например, Anbox/Waydroid), которые требуют рут-доступа и не работают на стандартных прошивках.
Почему ares-install пишет"No such device"?
Устройство не добавлено в конфигурацию CLI. Выполните ares-setup-device --name mytv --ip <IP_ТВ> и пройдите процедуру парсинга с PIN-кодом на экране телевизора. Проверьте, что IP актуален (меню Настройки → Сеть → Статус).
Нужен ли компьютер для каждой установки?
Если используете только ares-cli — да. Если установили Homebrew Channel — дальнейшие установки и обновления можно делать прямо с телевизора через его каталог или веб-интерфейс на порту 3000.
Будет ли работать приложение после обновления прошивки телевизора?
Обычно OTA-обновление сбрасывает Developer Mode и удаляет сторонние приложения. После обновления нужно заново включить режим разработчика и переустановить пакеты. Настройки аккаунта разработчика на портале LG сохраняются.
Где найти готовые.ipk файлы популярных приложений?
Основной каталог — репозиторий WebOS Brew (GitHub: webosbrew/webos-homebrew-apps). Там собраны порты Kodi, Jellyfin, Firefox, MPV и утилит. Скачивайте только релизы (Releases), избегайте непроверенных ссылок с форумов.