Луч: экран на телевизор и проектор
Луч транслирует экран 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_ADMIN | getcap /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.
Ссылки#
- Linux: github.com/Toxblh/luch-linux, altlinux.space/toxblh/luch-linux
- Android TV: github.com/Toxblh/luch-android, altlinux.space/toxblh/luch-android
Страница проекта на сайте: Луч.