Установка Homebrew Channel на телевизоры LG под управлением webOS требует активации режима разработчика и загрузки пакета установки с компьютера через командную строку. Официального приложения в LG Content Store не существует, поэтому процесс полностью опирается на инструменты сообщества, в частности на проект arons100. Действия отличаются в зависимости от версии webOS (1.0–6.0+), года выпуска модели и региональной прошивки.

Главное отличие от привычной установки APK на Android — необходимость использования ПК с установленным Node.js и утилитой webos-cli или графического установщика Homebrew Channel Installer. Телевизор и компьютер должны находиться в одной локальной сети, а на приемнике должен быть известен IP-адрес и Device ID, получаемый после входа в Developer Mode App.

Что такое Homebrew Channel на webOS и зачем он нужен

Homebrew Channel (HBC) — это независимый лаунчер домашних приложений (homebrew), позволяющий запускать неподписанные IPK-пакеты, отсутствующие в официальном магазине. С его помощью пользователи устанавливают медиаплееры с расширенной поддержкой кодеков, эмуляторы ретро-игр, клиенты для нестандартных стриминговых сервисов и утилиты системного мониторинга.

В отличие от взлома приставок, на webOS это реализуется через легальный API разработчика, предоставляемый LG. Система не требует рут-доступа или модификации загрузчика, однако установленные приложения работают в песочнице с ограниченными правами. Доступ к низкоуровневым функциям (например, прямое управление HDMI-CEC или чтение SMART-диска) остается закрытым без отдельных эксплойтов, которые быстро закрываются обновлениями.

⚠️ Внимание: установка стороннего ПО через Developer Mode может нарушить условия гарантии в некоторых регионах. LG не предоставляет техническую поддержку за проблемы, вызванные homebrew-приложениями. Перед началом рекомендуется создать точку восстановления системы, если модель это поддерживает.

Подготовка: оборудование, ПО и сетевые настройки

Для процесса понадобится компьютер под управлением Windows 10/11, macOS или Linux, USB-накопитель отформатированный в FAT32 (для некоторых методов первичной загрузки) и стабильное соединение по Ethernet или Wi-Fi 5 GHz. На ПК должен быть установлен Node.js LTS (версия 18.x или 20.x), так как webos-cli написан на JavaScript.

Отключите на роутере изоляцию клиентов (AP Isolation) и VPN-клиенты на ПК — они блокируют обнаружение телевизора по mDNS. Зафиксируйте IP-адрес телевизора в настройках DHCP роутера или назначьте статический адрес в меню Настройки → Сеть → Настройка IP. Это предотвратит потерю связи во время передачи пакетов.

  • 🖥️ Компьютер с Node.js LTS и Git
  • 📺 LG TV webOS 3.0+ (2016 год выпуска и новее)
  • 🔗 Ethernet-кабель или стабильный Wi-Fi 5 GHz
  • 💾 USB-флешка 1 ГБ+ (FAT32) для метода "Developer Mode App"

Активация режима разработчика на телевизоре

С 2016 года (webOS 3.0) LG использует приложение Developer Mode App, доступное в LG Content Store. Запустите магазин, найдите приложение по запросу "Developer Mode", установите и откройте его. При первом запуске потребуется принять пользовательское соглашение и ввести пароль разработчика — он понадобится позже для SSH-подключения.

После входа приложение покажет Device ID и IP-адрес. Нажмите кнопку "On" для включения режима. На моделях 2021–2026 гг. (webOS 6.0–24) интерфейс может отличаться: переключатель находится в верхнем правом углу, а логи выводятся во вкладке "Log". Если приложение выдает ошибку "Could not connect to server", проверьте дату и время на телевизоре — они должны синхронизироваться с NTP.

☑️ Проверка перед установкой

Выполнено: 0 / 6

На старых моделях (webOS 1.0–2.0, 2014–2015 гг.) используется другой метод: включение "Developer Mode" через скрытое меню пульта (комбинация кнопок varies by model) и установка утилиты ares-ide. Поскольку эти модели не получают обновления безопасности, использование их в домашней сети несет риски. Инструкции для Netcast-платформы здесь не рассматриваются.

Установка Homebrew Channel через командную строку (CLI)

Самый надежный способ — использование официального установщика из репозитория webosbrew/hb-channel. Откройте терминал (PowerShell или Terminal) и выполните команды по очереди. Утилита webos-cli установится глобально и добавит команду ares-install в PATH.

npm install -g @webosbrew/webos-cli

webos-cli install com.webosbrew.hbchannel

При первом запуске CLI запросит IP-адрес телевизора и Device ID. Введите их точно так, как показано в Developer Mode App. Если подключение прошло успешно, начнется передача IPK-пакета (около 5–10 МБ). На экране телевизора появится уведомление "Installing...", а затем иконка Homebrew Channel в лаунчере. Не выключайте телевизор до появления сообщения "Installation complete".

⚠️ Внимание: команда webos-cli install без аргументов пытается найти последний релиз на GitHub. Если репозиторий недоступен, скачайте .ipk файл вручную с страницы Releases и укажите путь к файлу: webos-cli install /путь/к/fайлу.ipk.
Альтернатива

графический установщик (Homebrew Channel Installer GUI):Для пользователей, не привыкших к терминалу, существует кроссплатформенное GUI-приложение на Electron. Оно автоматически определяет телевизоры в сети через mDNS, позволяет ввести Device ID в графическом окне и показывает прогресс-бар. Скачать можно со страницы релиза webosbrew/hb-channel-installer. Требует тех же предварительных условий: включенный Developer Mode и открытый порт 3000.

После установки запустите Homebrew Channel. При первом старте он скачает индекс репозитория приложений (файл index.json) с GitHub Pages. Если загрузка зависла на 0%, проверьте DNS-настройки телевизора — попробуйте указать 8.8.8.8 или 1.1.1.1 вручную.

Управление приложениями внутри Homebrew Channel

Интерфейс HBC разделен на вкладки: "Apps" (установленные), "Store" (каталог), "Settings". В Store представлены приложения, прошедшие базовую модерацию сообщества: MPV Player, RetroArch, Jellyfin Client, WebOS Homebrew App Store и др. Установка происходит по нажатию кнопки "Install" — пакет скачивается и устанавливается через тот же ares-install внутри песочницы.

Обновления проверяются автоматически при входе в Store. Для ручной установки IPK с флешки или локального сервера используйте раздел "Settings → Install from URL/IPK". Путь к файлу на флешке должен быть указан относительно корня: /usb1/filename.ipk. Флешка должна быть смонтирована (значок USB в верхнем меню webOS).

ПроблемаВозможная причинаДействие
Ошибка "Connection refused"Developer Mode выключен или неверный IPПроверьте статус в Developer Mode App, пинг IP с ПК
"Invalid Device ID"Опечатка или смена ID после перезагрузкиСкопируйте ID заново из приложения на ТВ
Зависание на "Installing..."Блокировка порта 3000 фаерволомДобавьте исключение для Node.js в Windows Defender
Приложение не запускаетсяНесовместимость версии webOSПроверьте minVersion в info.json приложения

Риски, ограничения и безопасность

Режим разработчика открывает порт 3000 (или 9998 на старых версиях) для входящих соединений без аутентификации, кроме Device ID. В домашней за NAT-роутером это приемлемо, но при подключении телевизора к публичной сети (гостевой Wi-Fi, мобильный хотспот) любой в той же подсети может установить ПО. Всегда выключайте Developer Mode после завершения работы: переключатель "Off" в приложении или команда webos-cli dev-mode off.

Обновления системного ПО (OTA) от LG могут сбросить режим разработчика и удалить Homebrew Channel. Обычно после обновления достаточно заново включить Developer Mode и переустановить HBC — пользовательские данные приложений (настройки, базы данных медиатеки) сохраняются, так как они лежат в отдельном разделе /var/luna/preferences/.

💡

Совет: Добавьте в закладки браузера страницу статуса GitHub (githubstatus.com) и репозиторий webosbrew. Если установка падает с сетевой ошибкой, часто виноваты временные проблемы с CDN GitHub Pages, а не ваша конфигурация.

💡

Главное: Homebrew Channel на LG — это не взлом, а использование официального API разработчика. Ключ к успеху — корректная сетевая настройка и актуальная версия Node.js на ПК.

Не пытайтесь установить приложения, требующие root-доступ (например, патчи системных библиотек или модули ядра) — они не работают в песочнице Developer Mode. Для таких задач требуются эксплойты уровня прошивки, которые нестабильны, привязаны к конкретным версиям ПО и категорически не рекомендуются для ежедневного использования.

Частые ошибки и их диагностика

Если после установки иконка Homebrew Channel отсутствует в лаунчере, но в Developer Mode App видно "Installed: com.webosbrew.hbchannel", попробуйте перезагрузить телевизор полным выключением из розетки на 30 секунд. webOS кэширует список установленных приложений, и иногда обновление лаунчера застревает.

Ошибка ENOENT: no such file or directory, open 'appinfo.json' при ручной установке означает, что IPK-пакет поврежден или собран неверно (неверная структура папок). Скачайте релиз заново, проверяя хеш SHA256, если он указан на странице загрузки. Не переименовывайте файл .ipk — имя пакета зашито внутри.

📊 Какой способ установки Homebrew Channel вы предпочитаете?
CLI (webos-cli) — полный контроль
GUI Installer — удобнее и нагляднее
Ручная установка IPK через Developer Mode App
Ещё не решался, изучаю тему

Альтернативы и дополнительные возможности

Если цель — просто запустить один конкретный плеер (например, для торрент-ссылок или специфического кодека), можно установить только его IPK без полного Homebrew Channel. Многие разработчики выкладывают готовые пакеты в своих репозиториях GitHub. Процесс идентичен: webos-cli install url_или_путь.

Для продвинутых пользователей существует webOS Homebrew App Store — отдельное приложение, устанавливаемое через HBC, которое агрегирует более широкий каталог, включая экспериментальные сборки. Также доступен rootmy.tv (для уязвимых версий webOS 4.x–5.x), дающий полный root через SSH, но его использование исключительно на ваш страх и риск и выходит за рамки стандартной процедуры Homebrew.

⚠️ Внимание: использование rootmy.tv или подобных эксплойтов безусловно аннулирует гарантию, может привести к "кирпичу" при неудачной прошивке и делает телевизор уязвимым для удаленного исполнения кода. Статья описывает только официальный путь через Developer Mode.
FAQ: Часто задаваемые вопросы
Работает ли это на LG с webOS 23/24 (2023–2026 гг.)?

Да, Developer Mode App доступен в магазине для актуальных версий webOS. Процедура идентична, но LG ужесточила политику модерации: некоторые старые homebrew-приложения могут не запускаться из-за обновленных библиотек Qt/QML или изменений в API. Проверяйте совместимость в описании конкретного приложения.

Нужен ли USB-накопитель для установки?

Для метода через CLI/PК — нет, передача идет по сети. USB-накопитель нужен только для первичной установки Developer Mode App, если телевизор не имеет доступа к LG Content Store (редкие региональные модели), или для установки IPK с флешки без ПК через файловый менеджер в HBC.

Можно ли вернуть телевизор в исходное состояние?

Да. Откройте Developer Mode App, переключите тумблер в положение "Off". Затем удалите Homebrew Channel как обычное приложение: долгое нажатие на иконку в лаунчере → значок корзины. Все связанные данные удалятся. Сброс на заводские настройки также очистит всё, но избыточен.

Почему не устанавливается приложение из Store внутри HBC?

Частая причина — несовпадение архитектуры (armv7 vs aarch64) или минимальная версия webOS. Откройте лог установки в HBC (обычно доступен в настройках или через SSH: journalctl -u webosbrew-hbchannel). Также проверьте свободное место: df -h /var через SSH.

Блокирует ли LG аккаунты за использование Homebrew?

На данный момент нет подтвержденных случаев блокировки LG Account или доступа к официальным сервисам (Netflix, Disney+, LG Channels) только за наличие Developer Mode или Homebrew Channel. Однако использование приложений для обхода DRM или пиратского контента нарушает ToS провайдеров контента, что несет риски блокировки аккаунтов самих сервисов.