Script Follower

Ascolta le voci degli attori da una scheda audio, capisce in che punto del copione si trova lo spettacolo e fa scorrere il PDF del copione di conseguenza. Nei punti scelti in preparazione mostra annotazioni e pulsanti OSC per CueStage, QLab, SCS, ChamSys MagicQ o qualunque dispositivo OSC.

Stesso stack e stessa veste grafica di CueStage: Python 3, PySide6 (Qt, stile Fusion scuro), sounddevice/PortAudio, python-osc. In più: Vosk (riconoscimento vocale offline) e PyMuPDF (PDF); per lo sloveno Whisper (CTranslate2).

Interfaccia in italiano, inglese e sloveno; copioni in italiano, inglese e sloveno.

Pacchetti portable per Linux (AppImage), Windows (cartella in uno zip) e macOS (.app in un .dmg), costruiti da GitHub Actions con il modello vocale italiano già incluso: nessuna installazione, funziona anche da chiavetta.

Come funziona

1. Ascolto: il canale scelto della scheda audio passa per un gate (soglia + hold): sotto la soglia al riconoscitore arriva silenzio.
2. Riconoscimento: Vosk, offline, con il vocabolario limitato alle parole del copione (molto più affidabile con i modelli piccoli).
3. Allineamento: le ultime ~10 parole sentite vengono confrontate con il copione intorno alla posizione corrente (allineamento locale tollerante a errori, parole saltate o aggiunte). Ci si sposta solo quando la corrispondenza è sicura. Se l'attore salta una scena, ci si riaggancia cercando in tutto il copione, ma serve una corrispondenza nettamente migliore e confermata due volte.
4. Scorrimento: la riga detta è evidenziata e tenuta a circa un terzo dell'altezza della finestra.

Nelle prove simulate sul copione «Il segreto di Francesco», con il 30% di parole sbagliate o perse la posizione resta in media entro una parola. Dopo un salto di centinaia o migliaia di parole, anche all'indietro, si riaggancia in 6–14 parole.

This is the beginning of the README. Read the rest at the original. Read the full README ↗