Programaciones: comandos CLI

Mostrar la programación de la lista de reproducción de una pantalla y la lista que actualmente selecciona.

screen schedule show <id>

screenrig screen schedule show scr_CAFE

data contiene entries (vacío cuando la pantalla no tiene programación), updated_at y effective_playlist. La salida JSON puede enviarse directamente a screen schedule set --file.

Reemplazar la programación de la lista de reproducción en una pantalla o flota.

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 lista de reproducción que un horario nombra se valida como una asignación, y la pantalla necesita una lista de reproducción predeterminada asignada. Las horas de las entradas se leen en la zona horaria propia de la pantalla. Cuando ninguna entrada rige, se reproduce la lista asignada. Si una lista programada no puede mostrarse después, sus entradas se omiten y se registra screen.playlist_unavailable.

Eliminar la programación de la lista de reproducción de una pantalla o flota.

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

screenrig screen schedule clear --tag Cafe

Después se reproduce la toma de control; si no, una campaña que se cumpla; si no, la lista de reproducción asignada. Una pantalla sin programación responde sin cambios.

Mostrar qué cambiaría reemplazar el horario de listas de reproducción de una pantalla, sin hacerlo.

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

No se escribe nada. Las entradas se comprueban como las comprueba screen schedule set, así que una vista previa rechaza lo que rechaza el set. data.gained y data.lost, cada uno {count, screen_ids}, dicen si la pantalla ganaría o perdería niveles de su horario; una entrada con "paused": true no está en ninguna pantalla, así que publicarla la gana. data.calendar.before y data.calendar.after son el calendario de la pantalla tal como es y tal como sería entre --calendar-from y --calendar-to.

Listar las revisiones del horario de listas de reproducción de una pantalla, la más reciente primero.

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

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

data.items contiene como máximo 50 revisiones, cada una con revision (la revisión de la pantalla en la escritura, por lo que los números tienen huecos donde la pantalla cambió de otro modo), created_at, change, current, author cuando se conoce y entries, el horario completo después de esa escritura (none significa que la pantalla no tenía horario). change es edited (un set, un clear o una importación de horarios), restored (una copia de la revisión anterior que nombra restored_from) o baseline (la programación que tenía la pantalla cuando empezó su historial). Mientras data.next_cursor sea una cadena, quedan revisiones más antiguas: ejecute el comando de nuevo con --after establecido en ese valor. Las revisiones se van con la purga de la pantalla. Basta con acceso de solo lectura.

Volver a poner en una pantalla el horario de una revisión anterior copiándolo hacia delante.

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

Las entradas de la revisión N pasan a ser el horario de la pantalla, la misma escritura que screen schedule set con esas entradas (o screen schedule clear cuando esa revisión no tenía ninguna), comprobadas como se comprueban ahora: una lista de reproducción eliminada desde entonces la rechaza. Con acceso Propose, o en un proyecto que exige revisión de los cambios de los agentes, la restauración espera a una persona como el set, y nada cambia en pantalla hasta que la aprueba. Las revisiones anteriores quedan como estaban.

Mostrar una lista de reproducción en una pantalla o en una flota antes de las campañas, el horario y la asignación.

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 es la abreviatura de screen takeover set ID. Un takeover nuevo reemplaza al anterior, salvo la misma lista de reproducción enviada de nuevo mientras su takeover está vigente, sin --reason o con el mismo, que conserva ese takeover y solo mueve su final. Cuando termina, la pantalla vuelve a una campaña que rige, a su programación o a su lista de reproducción asignada por sí sola. Un takeover cuya lista de reproducción no puede mostrarse termina. Una reejecución --for tras un fallo ambiguo calcula un nuevo final y se envía como una nueva solicitud.

Finalizar la toma de control en una pantalla o una flota.

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

screenrig screen takeover clear --tag Lobby

Después se reproduce una campaña que se cumpla; si no, la programación; si no, la lista de reproducción asignada. Una pantalla sin toma de control responde sin cambios.

Comprueba una hoja de filas de programación y muestra una vista previa de lo que hace; --commit la 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

Sin --commit no se escribe nada. data es la vista previa: valid, fingerprint, summary (rows, rows_with_errors, levels, creates, updates, unchanged, removes, screens, playlists), rows, levels, removals y calendar, ignored_columns para una columna que nada lee, y next, el comando que confirma. Las filas que coinciden en contenido, horas, prioridad y nombre forman un solo nivel: una pantalla es una entrada de la programación propia de esa pantalla, y varias pantallas, una carpeta o una etiqueta forman un nivel compartido, una campaña que prevalece sobre los niveles propios de una pantalla.

Una hoja válida termina con 0. Las filas con errores terminan con 8 y data.valid false: data.rows[].errors nombra la columna y el código de cada celda, no se escribe nada, --commit no confirma nada, y se vuelve a ejecutar el mismo comando una vez corregidas las filas.

Con --commit, la ejecución envía el fingerprint de la vista previa y una clave de idempotencia derivada del nombre y de la huella, por lo que repetir un comando idéntico interrumpido es seguro. data es entonces la vista previa más data.applied (creates, updates, unchanged, removes, screens, playlists) y data.committed true, y las listas de reproducción de un solo archivo que necesitan los archivos de la hoja se crean primero. Todas las filas se aplican o ninguna. Un proyecto que cambió desde la vista previa, o filas que se leen de otra forma, es schedule_import_stale (salida 5): no se escribió nada, y el mismo comando vuelve a mostrar la vista previa. Una confirmación que alcanza una pantalla de una carpeta protegida se rechaza por completo con protected_target (salida 5), y la que actualiza o elimina una campaña reservada responde reserved_item (salida 3) salvo que la confirme una persona que puede aprobar. La vista previa requiere acceso de solo lectura, y --commit requiere acceso de administración. Un archivo que la CLI no puede leer es un usage_error (salida 2).

Guarda una hoja con las columnas que lee una importación de programación y tres filas de ejemplo.

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

Las filas de ejemplo son un código de pantalla, una carpeta de pantallas y una etiqueta. Con --output, data contiene format, output, bytes y next, el comando schedule import para el archivo guardado. Un archivo --output existente y no vacío falla con usage_error (salida 2) y queda como estaba salvo que se pase --overwrite. Rellene una fila por pantalla y archivo, y luego ejecute schedule import FILE para ver la vista previa.