LUCH
IT
Home / Come funziona

Come funziona Luch

Due parti: un servizio sul computer e un'app ricevitore sullo schermo. Il servizio prende immagine e audio, li codifica e li invia via UDP, il ricevitore li decodifica e li mostra.

Modalità di trasmissione

ModalitàCosa mostraRitardo del mittente
fasttutto il monitor principale direttamente dal frame buffer (KMS), il cursore viene disegnato sopra; HEVC o H.264, a seconda del ricevitore≈ 5–6 ms
monitoruno schermo tramite il portale di sistema (PipeWire, DMA-BUF, senza copie)≈ 15–25 ms
windowuna finestra tramite il portalecome monitor
virtualun secondo schermo che estende il desktop (in GNOME viene creato un monitor virtuale)come monitor

Le cifre vengono dalla documentazione del progetto. L'audio (Opus, frame da 5 ms) viene preso dall'uscita principale in tutte le modalità.

Da dove viene il ritardo ridotto

Cattura e codificaRete, in un sensoDecodifica sul ricevitoreTotale, senza il display
≈ 5,5 ms≈ 2 ms≈ 5,5 ms (HEVC)≈ 13 ms

Gli accorgimenti: nemmeno una copia in più del fotogramma, un solo fotogramma di riferimento e niente B-frame, un gruppo di immagini infinito con fotogramma chiave su richiesta, un buffer di un fotogramma, la modalità più veloce del codificatore. I pacchetti partono nel momento in cui il codificatore li consegna.

Esempi di misure

DispositivoModalitàCatturaConversioneCodificaTotale sul mittente
Steam Deck (AMD), fotogramma 1280×800, 60 fotogrammi/sfast≈ 0,08 ms≈ 2,3 ms≈ 9,4 ms≈ 12 ms

I dati vengono dal log dell'helper luch-kms durante una trasmissione su un Google TV Streamer. Le misure di altri dispositivi saranno aggiunte.

Di cosa è fatto

ParteCosa fa
luchdil servizio utente: trova i ricevitori in rete (Avahi, _luch._tcp), mantiene i canali di controllo, cattura e invia immagine e audio, espone l'API D-Bus dev.luch.Luch1
luch-kmsun piccolo helper per la modalità a ritardo minimo: legge il frame buffer, lo converte in NV12 sulla GPU, codifica tramite VA-API. L'unica parte con privilegi elevati (CAP_SYS_ADMIN)
luchctll'utilità da riga di comando: elenco, trasmissione, arresto, statistiche
il ricevitoreun'app Android: mostra l'immagine, riproduce l'audio, calcola le statistiche

Cosa serve

Il computer

Linux con un codificatore VA-API e Mesa EGL. Le schede grafiche Intel e AMD sono supportate completamente. Le modalità tramite portale richiedono una sessione GNOME su Wayland. La modalità fast funziona in qualsiasi compositor che porti l'immagine via KMS.

Il ricevitore

Un dispositivo con Android 5.0 o successivo e l'app Luch. Deve essere sulla stessa rete del computer: mDNS non attraversa i router.

La rete

Una rete locale, meglio Wi-Fi a 5 GHz o cavo. Il flusso è legato all'interfaccia di rete su cui è stato trovato il ricevitore, quindi una VPN a tunnel completo non lo trasporta.