Git

Луч: экран на телевизор и проектор

Луч транслирует экран Linux на телевизор, проектор или приставку с Android TV с задержкой около 13 мс. Службу и консольную программу написал toxblh, исходный код открыт (GPL-3.0). В Atomic Niri Луч подключён к Niti и Tuner.

Как это устроено#

ЧтоГде
Службапользовательская luchd.service, шина D-Bus dev.luch.Luch1, объект /dev/luch/Luch1
Консольная программаluchctl (команды и текстовый интерфейс)
Помощник захватаluch-kms, читает буфер кадра из KMS, право cap_sys_admin
Приёмникприложение для Android TV, объявляет себя в сети как _luch._tcp (mDNS)
Режим по кнопке Niti~/.config/niti-vala/widgets/luch/config.json, поле mode

Приёмники ищутся через Avahi, поэтому телевизор и компьютер должны быть в одной подсети. Потоки привязаны к интерфейсу, на котором найден приёмник, и не уходят в VPN.

Режимы#

РежимЧто показывает
fastвесь основной монитор из буфера кадра (KMS), самая низкая задержка, ≈5–6 мс на компьютере
monitorэкран через портал захвата (PipeWire), ≈15–25 мс
windowодно окно через портал
virtualрасширение рабочего стола виртуальным монитором

Кодек выбирается по тесту приёмника: HEVC, если он там быстрее, иначе H.264. Звук идёт в формате Opus.

Как пользоваться#

В быстрых настройках Niti плитка «Луч»: нажатие запускает режим по умолчанию на последний или единственный приёмник, стрелка открывает список приёмников и режимов. Кнопка на панели стоит после раскладки клавиатуры и видна, только пока работает luchd. Режим по умолчанию выбирается на странице «Луч» в Tuner.

Из терминала:

luchctl list # найденные приёмники luchctl mirror # весь экран, режим fast luchctl mirror "Проектор" window # приёмник и режим luchctl stats # задержка, кадры, битрейт luchctl stop

Без аргументов luchctl открывает текстовый интерфейс.

Для своих программ#

Всё, что делают luchctl, плитка и страница Tuner, доступно по D-Bus:

gdbus introspect --session --dest dev.luch.Luch1 --object-path /dev/luch/Luch1

Основные методы: Receivers, Mirror(id, source), StopMirror(id), Disconnect(id), Stats(id); сигнал ReceiversChanged. Описание в репозитории проекта, файл docs/dbus.md.

Если что-то не работает#

СимптомЧто проверить
luchctl list пустзапущено ли приложение на телевизоре, работает ли avahi-daemon, в одной ли подсети устройства
Режим fast просит CAP_SYS_ADMINgetcap /usr/bin/luch-kms должен показывать cap_sys_admin; иначе sudo setcap cap_sys_admin+ep /usr/bin/luch-kms
Плитка пишет «luchd не запущен»systemctl --user status luchd

Логи службы: journalctl --user -u luchd -f.

Ссылки#

Страница проекта на сайте: Луч.