Configurar screenRIG em Gemini Spark

Spark é o agente pessoal de IA do Google dentro do Gemini Apps: você trabalha em um thread de tarefa, não em um terminal. Voltar ao início.

Obter Gemini Spark

1. 01

   Abrir Gemini Spark. Comece na visão geral do Spark do Google, depois abra o app Gemini e escolha Alternar para Spark. No app Gemini no Mac, escolha Spark → Tarefas.

2. 02

   Verificar disponibilidade. Siga artigo de ajuda Spark do Google para requisitos atuais de conta, assinaturas, plataformas e disponibilidade por país.

Sua conta Google é separada da sua conta screenRIG. Mantenha-as separadas: Spark nunca precisa da sua senha screenRIG ou tokens de API.

Peça ao Spark para instalar o screenRIG

Iniciar uma tarefa Spark com autorização explícita:

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

O plugin oficial inclui a habilidade screenRIG e o CLI que seu agente usa para operar telas; seu CLI precisa do Node.js 22.23.4+, 24.22.1+ ou 26.12.1+ (exceto 23.x e 25.x). Use o prompt de tarefa acima em vez dos comandos do marketplace Claude Code, Codex ou Grok: esses comandos não são para Spark. Revise as aprovações de instalação e acesso a ferramentas que o Spark solicita na thread da tarefa.

Verifique o ambiente de execução

Uma resposta Spark descrevendo sucesso não é prova. Peça para mostrar a saída do comando:

screenrig version
screenrig doctor

Para um plugin instalado, siga o configuração do PATH da sessão do Início. Peça ao Spark para executar node --version se version falhar com erro Node.

Execução remota de código Spark e arquivos remotos salvos vivem no computador remoto do Google, não na sua máquina. Se esse ambiente não puder executar a CLI incluída — sem shell, sem Node.js 22.23.4+, 24.22.1+ ou 26.12.1+ (exceto 23.x e 25.x), ou comandos bloqueados — pare e pergunte qual capacidade está faltando. Continuar só com resposta de chat deixa o plugin não instalado. Nesse caso use Claude Code ou ChatGPT Codex, que executam o mesmo plugin na sua máquina.

Criar seu projeto screenRIG

Forneça ao Spark seu e-mail de contato atual e use o nome da organização já fornecido, ou o padrão Screens. Seu agente executa screenrig agent enroll --email ADDRESS --organization "Screens" para criar sua identidade, organização, projeto Screens e associação, e envia um convite de membro por e-mail. Esse e-mail é seu login no dashboard, e nada depende dele: seu agente segue direto para parear sua tela e criar conteúdo. Abra-o sempre que quiser que o dashboard crie uma passkey, ou faça login com seu acesso existente para adicionar o projeto. O dashboard mostra seus projetos e permite alternar entre eles.

Para entrar nesta instalação em um projeto que você pertence, use screenrig login: você verifica o código mostrado, depois escolhe o projeto e seu acesso no dashboard. Nunca cole senhas, links de convite ou tokens de API na conversa. Veja Acesso ao projeto.

Emparelhe seu Player e publique

1. 01

   Abrir um Player. No dispositivo que controla sua tela, abra play.screenrig.ai/player/ ou siga Downloads e configuração do Player. Use o aplicativo web Player (PWA). Envie o código de pareamento para o Spark para que ele possa rodar screenrig screen pair CODE e confirmar a tela pretendida com screenrig screen list.

2. 02

   Descreva o resultado. Diga ao Spark o que mostrar, qual tela usar e quando.

3. 03

   Publique e verifique. Peça para Spark publicar, inspecione uma captura de tela e registros de reprodução, depois confirme o resultado na tela física você mesmo.

Já tem um código Player? Você pode combinar a solicitação:

Use screenrig.ai para minha tela do saguão. Meu código de pareamento é [code]. Crie um quadro de boas-vindas usando meu calendário de eventos. Pergunte-me qualquer outra coisa que precisar.

Se o Player nunca aparecer em screenrig screen list, confirme que o Player está aberto e sua configuração está completa, então envie o código de pareamento novamente.

Fontes e programações opcionais

Spark pode funcionar a partir de fontes conectadas opcionais — apps Google e apps conectados personalizados — e de skills que você define. Conexões estão desligadas por padrão: aprove apenas o acesso que uma tarefa precisa e mantenha planilhas de menu, calendários ou outras fontes de tela apenas para o que você quer que o Spark leia.

Agendas Spark controlam quando o agente executa uma tarefa; agendas de playlist screenRIG controlam quando o conteúdo é reproduzido na tela. São separadas. Adicione uma tarefa recorrente Spark somente após sua primeira publicação ser verificada, usando fontes que você já autorizou. A tarefa pode atualizar e republicar conteúdo, mas o Player da sua tela deve estar aberto para mostrar.

Se a configuração travar

• Spark não pode executar o CLI incluído. Pare e nomeie a capacidade ausente, depois use Claude Code ou ChatGPT Codex.
• version falha em um erro do Node. Peça ao Spark para verificar node --version e garantir que o Node.js 22.23.4+, 24.22.1+ ou 26.12.1+ (exceto 23.x e 25.x) esteja instalado em seu ambiente de execução.
• Um comando de conta reporta not_enrolled. Esta instalação ainda não possui credenciais de conta: nova conta screenrig agent enroll --email ADDRESS, conta existente screenrig login.
• screen list não retorna nada. Confirme que o Player está aberto, compartilhe seu código de pareamento e peça ao Spark para completar screenrig screen pair CODE antes de listar as telas novamente.

Continue trabalhando com a mesma tarefa Spark em vez de criar outra conta. Tabela completa: Quando a primeira execução falha.

Próximo

Voltar para Início, abrir o Guia dos Players ou Escolher um caminho de autoria.