Луч: экран на проектор без ожидания
Открытая трансляция экрана Linux на телевизор или проектор. Удобство AirPlay и отзывчивость игрового стриминга: картинка на экране через 13 миллисекунд, а не через секунды.
Что это
Луч показывает экран компьютера на телевизоре, проекторе или приставке с Android TV. На компьютере работает небольшая служба, на телевизоре приложение-приёмник. Они сами находят друг друга в домашней сети, и трансляция включается одним нажатием.
Проект написал toxblh, автор Dozor. Исходный код открыт, лицензия GPL-3.0.
Зачем он нужен
Автор хотел вывести ролик с обычного сайта на проектор и перебрал готовые решения. У одних пропадал звук, у других задержка росла со временем, по DLNA картинка приходила позже чем через 15 секунд. Так появился Луч: для просмотра видео это неважно, а для игр, презентаций и работы за большим экраном задержка в секунды делает трансляцию бесполезной.
Быстро
Около 13 мс от кадра на компьютере до картинки на проекторе. Это цифры автора на проекторе XGIMI MoGo 4 Laser по Wi-Fi, на другом железе результат будет другим.
Со звуком
Звук передаётся вместе с картинкой в формате Opus короткими кадрами по 5 мс, отдельно настраивать ничего не нужно.
Без ручной настройки
Приёмник появляется в сети сам и выбирает самый быстрый для своего железа видеокодек: HEVC или H.264.
Откуда берутся 13 миллисекунд
| Этап | Время | Что происходит |
|---|---|---|
| Захват и кодирование | ≈5,5 мс | кадр берётся прямо из буфера видеокарты (KMS) без лишних копий и сразу кодируется на видеокарте через VA-API |
| Wi-Fi | ≈2 мс | пакеты уходят сразу, как только кодировщик вернул их, без накопления в очереди |
| Декодирование на телевизоре | ≈5,5 мс | аппаратный декодер приёмника |
Сумма без учёта собственной задержки самого экрана или проектора. Трюки те же, что у игровых стримингов: без B-кадров, с одним опорным кадром, с бесконечной длиной группы кадров, с мгновенным опорным кадром по запросу. Сокеты привязаны к интерфейсу локальной сети, поэтому VPN с полным туннелем поток не заберёт.
Режимы
| Режим | Что показывает | Задержка на компьютере |
|---|---|---|
fast | весь основной монитор прямо из буфера кадра (KMS), курсор дорисовывается | ≈5–6 мс |
monitor | экран через системный диалог захвата (портал, PipeWire) | ≈15–25 мс |
window | одно окно | ≈15–25 мс |
virtual | расширение рабочего стола: на телевизор выводится новый виртуальный монитор | ≈15–25 мс |
Режимы через портал рассчитаны на GNOME. В Atomic Niri самый быстрый режим fast не зависит от оболочки и работает там, где экран выводится через KMS. Для него пакету выдаётся право cap_sys_admin: иначе ядро не отдаёт чужой буфер кадра.
Луч в Atomic Niri
Луч встроен в систему, отдельно настраивать панель не нужно.
- Плитка «Луч» в быстрых настройках Niti: нажатие включает трансляцию в режиме по умолчанию на последний или единственный приёмник и выключает её; стрелка открывает список приёмников и режимов. В подзаголовке плитки видна задержка.
- Кнопка на панели сразу после раскладки клавиатуры. Она видна, только пока запущена служба
luchd. Левая кнопка мыши запускает или останавливает трансляцию, правая открывает настройки. - Страница «Луч» в Tuner: состояние службы, список приёмников и выбор режима для кнопки.
- Пакет
luchставит службуluchd, консольную программуluchctlи помощникluch-kms.
Сейчас Луч добавлен в сборки ветки dev-test. В основной канал он попадёт после проверки.
Как начать
- Поставьте приёмник на телевизор. Приложение для Android TV, Google TV и проекторов: репозиторий luch-android. Установка через
adb install, подробности и права на показ поверх других окон в его README. Заявка на публикацию в F-Droid подана. - Убедитесь, что устройства в одной сети. Обнаружение идёт через mDNS (Avahi), он не проходит через маршрутизаторы. Телевизор должен быть в той же подсети, что и компьютер.
- Запустите трансляцию. Плиткой в Niti или командой:
luchctl list # найденные приёмники
luchctl mirror # весь экран, самый быстрый режим
luchctl mirror "Проектор" window # конкретный приёмник и режим
luchctl stats # задержка, кадры в секунду, битрейт
luchctl stop
Команда luchctl без аргументов открывает консольный интерфейс: цифры и буквы переключают режимы, s останавливает. Для своих программ есть D-Bus API dev.luch.Luch1 на сессионной шине. На нём же построены плитка, кнопка и страница Tuner.
Если приёмников нет
- приложение на телевизоре не запущено;
- не работает
avahi-daemon; - устройства в разных сегментах сети.
Если режим fast пишет, что нужен CAP_SYS_ADMIN, выдайте право командой sudo setcap cap_sys_admin+ep /usr/bin/luch-kms (в образе это делается при установке).
Что дальше
Автор хочет сделать единый быстрый конвейер: собственный протокол как самый быстрый вариант, а для остальных устройств запасные варианты через Chromecast, Miracast, DLNA и, возможно, AirPlay. Чтобы можно было проецировать на всё, что умеет принимать картинку.
- режим медиа как у Chromecast: видео с управлением воспроизведением;
- фото и презентации с экраном докладчика;
- Windows и macOS: там пока планируется трансляция только на свой приёмник;
- главный приоритет сейчас: удобство и совместимость с разным железом на Linux.
Чем помочь проекту
Автор честно говорит: у него всё летает, но это не гарантия, что на другой видеокарте оно хотя бы заведётся. Больше всего нужны проверки на разном железе.
- Intel, AMD и NVIDIA, разные композиторы и разные устройства Android TV;
- отчёты об ошибках с логами (
journalctl --user -u luchd -f); - запросы на слияние приветствуются, в том числе написанные с помощью ИИ: важно, чтобы код собирался и был проверен. Напишите, на чём проверяли и что сработало, а что нет.
Ссылки
| Что | GitHub | ALT Linux Space |
|---|---|---|
Linux: служба, luchctl, luch-kms | Toxblh/luch-linux | toxblh/luch-linux |
| Android TV: приёмник | Toxblh/luch-android | toxblh/luch-android |
Лицензия GPL-3.0. Автор: toxblh.