Configura screenRIG in Gemini Spark

Spark è l'agente AI personale di Google dentro Gemini Apps: lavori in un thread di attività, non in un terminale. Indietro all'inizio.

Ottieni Gemini Spark

1. 01

   Apri Gemini Spark. Inizia dalla panoramica di Spark di Google, poi apri l’app Gemini e scegli Passa a Spark. Nell’app Gemini su Mac, scegli Spark → Attività.

2. 02

   Controlla disponibilità. Segui l’articolo di aiuto Spark di Google per i requisiti attuali di account, abbonamenti, piattaforme e disponibilità per paese.

Il tuo account Google è separato dal tuo account screenRIG. Tienili distinti: Spark non ha mai bisogno della tua password screenRIG o dei token API.

Chiedi a Spark di installare screenRIG

Avvia un'attività Spark con autorizzazione esplicita:

I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin.

Il plugin ufficiale include la skill screenRIG e la CLI che il tuo agente usa per gestire gli schermi; la sua CLI richiede Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (escluse 23.x e 25.x). Usa il prompt del task sopra invece dei comandi Claude Code, Codex o Grok marketplace: quei comandi non sono per Spark. Rivedi le approvazioni di installazione e accesso agli strumenti che Spark richiede nel thread del task.

Controlla l’ambiente di esecuzione

Una risposta Spark che descrive il successo non è una prova. Chiedi di mostrare l’output del comando:

screenrig version
screenrig doctor

Per un plugin installato, segui la configurazione del PATH di sessione di Avvio. Chiedi a Spark di eseguire node --version se version fallisce con un errore Node.

L'esecuzione remota del codice Spark e i file remoti salvati vivono sul computer remoto di Google, non sulla tua macchina. Se quell'ambiente non può eseguire la CLI inclusa — nessuna shell, nessun Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (escluse 23.x e 25.x), o comandi bloccati — fermati e chiedi quale capacità manca. Continuare solo da una risposta chat lascia il plugin non installato. In tal caso usa Claude Code o ChatGPT Codex, che eseguono lo stesso plugin sulla tua macchina.

Crea il tuo progetto screenRIG

Fornisci a Spark la tua email di contatto reale e usa il nome dell’organizzazione già fornito, oppure usa Screens come predefinito. Il tuo agente esegue screenrig agent enroll --email ADDRESS --organization "Screens" per creare la sua identità, organizzazione, progetto Screens e iscrizione, e ti invia via email un invito come membro. Quell’email è il tuo accesso al dashboard, e non devi aspettare nulla: il tuo agente procede direttamente ad associare il tuo schermo e a creare contenuti. Aprilo ogni volta che vuoi che il dashboard crei una passkey, oppure accedi con il tuo login esistente per aggiungere il progetto. Il dashboard mostra i tuoi progetti e ti permette di passare da uno all’altro.

Per accedere a questo installazione in un progetto di cui fai parte, usa screenrig login: controlli il codice mostrato, poi scegli il progetto e il suo accesso nel dashboard. Non incollare mai password, link di invito o token API nella conversazione. Vedi Accesso al progetto.

Associa il tuo lettore e pubblica

1. 01

   Apri un Player. Sul dispositivo che gestisce il tuo schermo, apri play.screenrig.ai/player/ o segui Download e configurazione Player. Usa l’app web Player (PWA). Invia il suo codice di associazione a Spark per farlo funzionare screenrig screen pair CODE e confermare lo schermo previsto con screenrig screen list.

2. 02

   Descrivi il risultato. Dì a Spark cosa mostrare, quale schermo usare e quando.

3. 03

   Pubblica e verifica. Chiedi a Spark di pubblicare, ispeziona uno screenshot e i record di riproduzione, poi conferma personalmente il risultato sullo schermo fisico.

Hai già un codice Player? Puoi combinare la richiesta:

Usa screenrig.ai per il mio schermo lobby. Il mio codice di associazione è [code]. Crea una bacheca di benvenuto usando il mio calendario eventi. Chiedimi tutto il resto che ti serve.

Se il Player non appare mai in screenrig screen list, conferma che il Player è aperto e la configurazione è completa, quindi invia di nuovo il codice di associazione.

Fonti e programmazioni opzionali

Spark può lavorare da fonti connesse opzionali — app Google e app connesse personalizzate — e da skill che definisci. Le connessioni sono disattivate di default: approva solo l'accesso necessario a un'attività e limita fogli di calcolo, calendari o altre fonti schermo a ciò che vuoi che Spark legga.

Le programmazioni Spark controllano quando l'agente esegue un'attività; le programmazioni playlist screenRIG controllano quando i contenuti vengono riprodotti sullo schermo. Sono separate. Aggiungi un'attività ricorrente Spark solo dopo che la tua prima pubblicazione è verificata, usando fonti già autorizzate. L'attività può aggiornare e ripubblicare contenuti, ma il Player dello schermo deve essere aperto per mostrarli.

Se la configurazione si blocca

• Spark non può eseguire la CLI inclusa. Interrompi e indica la capacità mancante, quindi usa Claude Code o ChatGPT Codex.
• version fallisce per un errore Node. Chiedi a Spark di controllare node --version e assicurati che Node.js 22.23.4+, 24.22.1+ o 26.12.1+ (escluse 23.x e 25.x) sia installato nel suo ambiente di esecuzione.
• Un comando account riporta not_enrolled. Questa installazione non ha ancora credenziali account: nuovo account screenrig agent enroll --email ADDRESS, account esistente screenrig login.
• screen list non restituisce nulla. Conferma che il lettore sia aperto, condividi il suo codice di associazione e chiedi a Spark di completare screenrig screen pair CODE prima di elencare di nuovo gli schermi.

Continua a lavorare con lo stesso task Spark invece di creare un altro account. Tabella completa: Quando il primo tentativo fallisce.

Avanti

Torna a Inizio, apri la guida Players o Scegli un percorso di authoring.