Луч: экран на проектор без ожидания

Открытая трансляция экрана Linux на телевизор или проектор. Удобство AirPlay и отзывчивость игрового стриминга: картинка на экране через 13 миллисекунд, а не через секунды.

Луч: ноутбук посылает луч света на экран, подпись «Луч · screen mirroring»
Луч · screen mirroring. Эмблема проекта.

Что это

Луч показывает экран компьютера на телевизоре, проекторе или приставке с 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. В основной канал он попадёт после проверки.

Как начать

  1. Поставьте приёмник на телевизор. Приложение для Android TV, Google TV и проекторов: репозиторий luch-android. Установка через adb install, подробности и права на показ поверх других окон в его README. Заявка на публикацию в F-Droid подана.
  2. Убедитесь, что устройства в одной сети. Обнаружение идёт через mDNS (Avahi), он не проходит через маршрутизаторы. Телевизор должен быть в той же подсети, что и компьютер.
  3. Запустите трансляцию. Плиткой в 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);
  • запросы на слияние приветствуются, в том числе написанные с помощью ИИ: важно, чтобы код собирался и был проверен. Напишите, на чём проверяли и что сработало, а что нет.