Agendamentos: comandos da CLI

Mostrar a programação da playlist de uma tela e a playlist que ela seleciona atualmente.

screen schedule show <id>

screenrig screen schedule show scr_CAFE

data contém entries (vazio quando a tela não tem programação), updated_at e effective_playlist. A saída JSON pode ir direto para screen schedule set --file.

Substituir a programação da playlist em uma tela ou frota.

screen schedule set (<id>... | --tag TAG | --folder ID) --file FILE [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule set scr_CAFE --file dayparts.json
screenrig screen schedule set --tag Cafe --file dayparts.json
screenrig screen schedule set --folder sfd_01EXAMPLEFOLDER000000000 --file dayparts.json

Cada playlist nomeada em uma programação é validada como uma atribuição, e a tela precisa de uma playlist padrão atribuída. Os horários das entradas são lidos no fuso horário próprio da tela. Quando nenhuma entrada vigora, a playlist atribuída é reproduzida. Se uma playlist programada não puder ser exibida depois, suas entradas são puladas e screen.playlist_unavailable é registrado.

Remover a programação da playlist de uma tela ou frota.

screen schedule clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule clear --tag Cafe

Depois, passa a tocar o takeover; senão, uma campanha que vale; senão, a playlist atribuída. Uma tela sem programação responde sem alteração.

Mostrar o que mudaria ao substituir o cronograma de playlists de uma tela, sem fazê-lo.

screen schedule preview <id> --file FILE [--calendar-from INSTANT] [--calendar-to INSTANT]

screenrig screen schedule preview scr_LOBBY --file dayparts.json
screenrig screen schedule preview scr_LOBBY --file dayparts.json --calendar-from 2026-12-01T00:00:00Z --calendar-to 2027-01-01T00:00:00Z

Nada é gravado. As entradas são verificadas como screen schedule set as verifica, então uma prévia recusa o que o set recusa. data.gained e data.lost, cada um {count, screen_ids}, dizem se a tela ganharia ou perderia níveis do seu cronograma; uma entrada com "paused": true não está em nenhuma tela, então publicá-la a ganha. data.calendar.before e data.calendar.after são o calendário da tela como está e como ficaria de --calendar-from a --calendar-to.

Listar as revisões do cronograma de playlists de uma tela, a mais recente primeiro.

screen schedule revisions <id> [--after CURSOR]

screenrig screen schedule revisions scr_LOBBY
screenrig screen schedule revisions scr_LOBBY --after CURSOR

data.items contém no máximo 50 revisões, cada uma com revision (a revisão da tela na gravação, por isso os números têm lacunas onde a tela mudou de outra forma), created_at, change, current, author quando conhecido e entries, o cronograma inteiro após essa gravação (none significa que a tela não tinha cronograma). change é edited (um set, um clear ou uma importação de cronograma), restored (uma cópia da revisão anterior que restored_from nomeia) ou baseline (a programação que a tela tinha quando seu histórico começou). Enquanto data.next_cursor for uma string, restam revisões mais antigas: execute o comando de novo com --after definido com esse valor. As revisões somem com a exclusão definitiva da tela. Acesso somente leitura basta.

Colocar de volta numa tela o cronograma de uma revisão anterior copiando-o para a frente.

screen schedule restore <id> --revision N [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule restore scr_LOBBY --revision 4
screenrig screen schedule restore scr_LOBBY --revision 4 --expect-rev 9

As entradas da revisão N tornam-se o cronograma da tela, a mesma gravação que screen schedule set com essas entradas (ou screen schedule clear quando essa revisão não tinha nenhuma), verificadas como são verificadas agora: uma playlist excluída desde então a recusa. Com acesso Propose, ou em um projeto que exige revisão das mudanças dos agentes, a restauração aguarda uma pessoa como o set, e nada muda na tela até que ela aprove. As revisões anteriores ficam como estavam.

Exiba uma playlist em uma tela ou frota antes de campanhas, da programação e da atribuição.

screen takeover [set] (<id>... | --tag TAG | --folder ID) --playlist-id ID [--until TIME | --for DURATION] [--reason TEXT] [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover scr_LOBBY --playlist-id pl_DRILL --for 30m --reason "Fire drill"
screenrig screen takeover --tag Lobby --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover --folder sfd_01EXAMPLEFOLDER000000000 --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover scr_A scr_B --playlist-id pl_NOTICE --until none

screen takeover ID é a abreviação de screen takeover set ID. Um takeover novo substitui o anterior, exceto a mesma playlist enviada de novo enquanto seu takeover está em vigor, sem --reason ou com o mesmo, o que mantém esse takeover e apenas move seu fim. Quando termina, a tela retorna automaticamente a uma campanha em vigor, à sua programação ou à sua playlist atribuída. Um takeover cuja playlist não pode ser exibida termina. Uma reexecução --for após uma falha ambígua calcula um novo fim e é enviada como uma nova solicitação.

Encerrar a tomada de controle em uma tela ou frota.

screen takeover clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover clear --tag Lobby

Depois, passa a tocar uma campanha que vale; senão, a programação; senão, a playlist atribuída. Uma tela sem takeover responde sem alteração.

Confere uma planilha de linhas de programação e mostra uma prévia do que ela faz; --commit a aplica.

schedule import <file> [--name NAME] [--timezone ZONE] [--code-field FIELD] [--commit]

screenrig schedule import schedule.csv
screenrig schedule import schedule.xlsx --name "Spring promos" --timezone America/Los_Angeles
screenrig schedule import schedule.csv --name "Spring promos" --commit
screenrig schedule import rows.json --code-field room_id
screenrig schedule import - --name "Spring promos" --commit

Sem --commit, nada é gravado. data é a prévia: valid, fingerprint, summary (rows, rows_with_errors, levels, creates, updates, unchanged, removes, screens, playlists), rows, levels, removals e calendar, ignored_columns para uma coluna que nada lê, e next, o comando que faz o commit. Linhas que coincidem em conteúdo, horários, prioridade e nome viram um único nível: uma tela é uma entrada da programação própria dessa tela, e várias telas, uma pasta ou uma tag são um nível compartilhado, uma campanha que prevalece sobre os níveis próprios de uma tela.

Uma planilha válida sai com 0. Linhas com erros saem com 8 e data.valid false: data.rows[].errors nomeia a coluna e o código de cada célula, nada é gravado, --commit não faz commit de nada, e o mesmo comando é executado de novo depois que as linhas são corrigidas.

Com --commit, a execução envia o fingerprint da prévia e uma chave de idempotência derivada do nome e da fingerprint, então repetir um comando idêntico interrompido é seguro. data passa a ser a prévia mais data.applied (creates, updates, unchanged, removes, screens, playlists) e data.committed true, e as playlists de um arquivo de que os arquivos da planilha precisam são criadas primeiro. Todas as linhas são aplicadas ou nenhuma. Um projeto que mudou desde a prévia, ou linhas lidas de outra forma, resulta em schedule_import_stale (exit 5): nada foi gravado, e o mesmo comando gera a prévia de novo. Um commit que alcança uma tela de uma pasta protegida é recusado por inteiro com protected_target (exit 5), e um que atualiza ou exclui uma campanha reservada responde reserved_item (exit 3), a menos que uma pessoa que pode aprovar faça o commit. A prévia exige acesso somente leitura, e --commit exige acesso Gerenciar. Um arquivo que a CLI não consegue ler é um usage_error (exit 2).

Salva uma planilha com as colunas que uma importação de programação lê e três linhas de exemplo.

schedule template [--format csv|xlsx] [--output FILE] [--overwrite]

screenrig schedule template
screenrig schedule template --output schedule.csv
screenrig schedule template --format xlsx --output schedule.xlsx --overwrite

As linhas de exemplo são um código de tela, uma pasta de telas e uma tag. Com --output, data traz format, output, bytes e next, o comando schedule import para o arquivo salvo. Um arquivo --output existente e não vazio falha com usage_error (exit 2) e permanece como estava, a menos que --overwrite seja passado. Preencha uma linha por tela e arquivo e depois execute schedule import FILE para ver a prévia.