Programmazioni: comandi CLI

Mostra la programmazione della playlist di uno schermo e la playlist attualmente selezionata.

screen schedule show <id>

screenrig screen schedule show scr_CAFE

data contiene entries (vuoto quando lo schermo non ha una programmazione), updated_at e effective_playlist. L’output JSON può tornare direttamente a screen schedule set --file.

Sostituisci la programmazione playlist su uno schermo o una fleet.

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

Ogni playlist nominata da una programmazione è validata come assegnazione, e lo schermo necessita di una playlist predefinita assegnata. Gli orari delle voci sono letti nel fuso orario proprio dello schermo. Quando nessuna voce è in vigore, si riproduce la playlist assegnata. Se una playlist programmata non può più essere mostrata, le sue voci sono saltate e screen.playlist_unavailable è registrato.

Rimuovi la programmazione playlist da uno schermo o una flotta.

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

screenrig screen schedule clear --tag Cafe

Dopo viene riprodotto il takeover, altrimenti una campagna che è valida, altrimenti la playlist assegnata. Uno schermo senza programmazione risponde senza modifiche.

Mostrare cosa cambierebbe sostituire il programma di playlist di uno schermo, senza farlo.

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

Non viene scritto nulla. Le voci sono controllate come le controlla screen schedule set, perciò un’anteprima rifiuta ciò che rifiuta il set. data.gained e data.lost, ciascuno {count, screen_ids}, dicono se lo schermo guadagnerebbe o perderebbe livelli del suo programma; una voce con "paused": true non è su alcuno schermo, quindi pubblicarla la guadagna. data.calendar.before e data.calendar.after sono il calendario dello schermo com’è e come sarebbe da --calendar-from a --calendar-to.

Elenca le revisioni del programma di playlist di uno schermo, la più recente per prima.

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

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

data.items contiene al massimo 50 revisioni, ciascuna con revision (la revisione dello schermo alla scrittura, perciò i numeri hanno lacune dove lo schermo è cambiato in altro modo), created_at, change, current, author quando noto e entries, l’intero programma dopo quella scrittura (none significa che lo schermo non aveva un programma). change è edited (un set, un clear o un’importazione di programmi), restored (una copia della revisione precedente indicata da restored_from) oppure baseline (la programmazione che lo schermo aveva all’inizio della sua cronologia). Finché data.next_cursor è una stringa, restano revisioni più vecchie: esegui di nuovo il comando con --after impostato su quel valore. Le revisioni vanno via con l’eliminazione definitiva dello schermo. Basta l’accesso in sola lettura.

Rimettere su uno schermo il programma di una revisione precedente copiandolo in avanti.

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

Le voci della revisione N diventano il programma dello schermo, la stessa scrittura di screen schedule set con quelle voci (o screen schedule clear se quella revisione non ne aveva), controllate come lo sono ora: una playlist eliminata nel frattempo la rifiuta. Con accesso Propose, o in un progetto che richiede revisione per le modifiche degli agenti, il ripristino attende una persona come il set, e sullo schermo non cambia nulla finché non lo approva. Le revisioni precedenti restano com’erano.

Mostra una playlist su uno schermo o una flotta prima delle campagne, della programmazione e dell’assegnazione.

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 è l’abbreviazione di screen takeover set ID. Un nuovo takeover sostituisce quello precedente, tranne la stessa playlist inviata di nuovo mentre il suo takeover è in vigore, senza --reason o con lo stesso, che mantiene quel takeover e ne sposta soltanto la fine. Quando termina, lo schermo torna automaticamente a una campagna in vigore, al suo programma o alla playlist assegnata. Un takeover la cui playlist non può essere mostrata termina. Una riesecuzione --for dopo un errore ambiguo calcola una nuova fine ed è inviata come nuova richiesta.

Termina il takeover su uno schermo o una flotta.

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

screenrig screen takeover clear --tag Lobby

Dopo viene riprodotta una campagna che è valida, altrimenti la programmazione, altrimenti la playlist assegnata. Uno schermo senza takeover risponde senza modifiche.

Controlla un foglio di righe di programmazione e mostra un’anteprima di ciò che fa; --commit lo applica.

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

Senza --commit non viene scritto nulla. data è l’anteprima: valid, fingerprint, summary (rows, rows_with_errors, levels, creates, updates, unchanged, removes, screens, playlists), rows, levels, removals e calendar, ignored_columns per una colonna che nessuno legge, e next, il comando che esegue il commit. Le righe che coincidono per contenuto, orari, priorità e nome diventano un solo livello: uno schermo è una voce della programmazione propria di quello schermo, e più schermi, una cartella o un tag sono un livello condiviso, una campagna che ha la precedenza sui livelli propri di uno schermo.

Un foglio valido termina con 0. Le righe con errori terminano con 8 e data.valid false: data.rows[].errors indica colonna e codice di ogni cella, non viene scritto nulla, --commit non conferma nulla, e lo stesso comando si esegue di nuovo dopo aver corretto le righe.

Con --commit, l’esecuzione invia il fingerprint dell’anteprima e una chiave di idempotenza derivata dal nome e dal fingerprint, quindi rieseguire un comando identico interrotto è sicuro. data è allora l’anteprima più data.applied (creates, updates, unchanged, removes, screens, playlists) e data.committed true, e le playlist di un solo file di cui i file del foglio hanno bisogno vengono create per prime. Tutte le righe si applicano o nessuna. Un progetto cambiato dopo l’anteprima, o righe lette in modo diverso, dà schedule_import_stale (exit 5): non è stato scritto nulla, e lo stesso comando mostra di nuovo l’anteprima. Un commit che raggiunge uno schermo in una cartella protetta viene rifiutato per intero con protected_target (exit 5), e uno che aggiorna o elimina una campagna riservata risponde con reserved_item (exit 3), a meno che non lo esegua una persona che può approvare. L’anteprima richiede l’accesso in sola lettura, e --commit richiede l’accesso Gestisci. Un file che la CLI non può leggere è un usage_error (exit 2).

Salva un foglio con le colonne che legge un’importazione della programmazione e tre righe di esempio.

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

Le righe di esempio sono un codice schermo, una cartella di schermi e un tag. Con --output, data contiene format, output, bytes e next, il comando schedule import per il file salvato. Un file --output esistente e non vuoto fallisce con usage_error (exit 2) e resta com’era, a meno che non venga passato --overwrite. Compila una riga per schermo e file, poi esegui schedule import FILE per vederne l’anteprima.