Referencia de comandos CLI

Leer el registro del proyecto y su crédito restante.

project show

Sin parámetros.

screenrig project show

data.credit_remaining es un conteo entero total de créditos. Por debajo de 1000 el sobre puede llevar una advertencia credits_low. Hasta el 1 de enero de 2027 el uso es gratuito dentro de lo razonable, por lo que el crédito restante es un medidor entero que un agente puede leer, no una instrucción de corte.

Establecer el nombre que las personas ven en el conmutador de proyectos del panel.

project rename NAME

Leer el plan del proyecto, las banderas de función independientes screens y advertiser y el conjunto de capacidades efectivas. Una denegación de ruta prevalece sobre una lectura de capacidad obsoleta.

project capabilities

Leer la disponibilidad diaria de pantallas del proyecto durante días UTC.

project uptime [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD]

screenrig project uptime
screenrig project uptime --day-from 2026-09-01 --day-to 2026-09-30

El rango y los valores predeterminados son los de screen uptime. data.items lista una fila por día UTC, del más antiguo al más reciente: online_s y offline_s sumados sobre las pantallas con estado registrado ese día, availability, coverage (la proporción del día de esas pantallas con estado registrado) y screens (cuántas tenían estado registrado). La fila de hoy cubre intervalos que terminaron hasta ahora; screen list muestra quién está en línea ahora.

Leer la salud de la flota por hora UTC: pantallas reportando, calientes, pantalla desconectada, fallando.

project health-trend [--from TIME] [--to TIME]

screenrig project health-trend
screenrig project health-trend --from 7d

data.items lista la salud de la flota por hora UTC: hour, screens_reporting, hot (temperatura máxima igual o superior a 80 °C), display_disconnected, y crashing (3 o más fallos en 24 horas). La CLI sigue next_cursor hasta el final y responde cada hora con next_cursor null. Las horas siguen a los informes con hasta unos 5 minutos de retraso.

Crear, listar o revocar invitaciones para miembros del proyecto y compradores de anuncios.

invitations create --email ADDRESS[,ADDRESS] [--kind member|ad-buyer]
invitations create --link
    [--screen-id ID] [--slot-id ID] [--policy trusted|review_required]
invitations list [--kind member|ad-buyer] [--status STATUS]
invitations revoke ID

--kind predetermina a member. La entrega por correo electrónico es la predeterminada y expira después de siete días. --email acepta destinatarios separados por comas, hasta cincuenta por solicitud. --link es solo para miembros, requiere exactamente un destinatario previsto y devuelve una URL de invitación de veinticuatro horas una vez para entrega directa. Nunca ponga esa URL en registros, notas o una transcripción compartida. Las listas nunca la devuelven.

Los compradores de anuncios usan solo correo electrónico y necesitan un alcance de pantalla o espacio propio (o ambos). --screen-id y --slot-id aceptan IDs separados por comas; --policy selecciona trusted o review_required. Los filtros de estado son queued, sent, issued, accepted, revoked, expired y failed.

screenrig invitations create --email teammate@example.com
screenrig invitations create --kind ad-buyer --email buyer@example.com --screen-id scr_LOBBY --policy review_required

Los agentes no aceptan invitaciones. La persona invitada abre el correo, inicia sesión o crea una passkey, y acepta en el panel. El registro por enlace verifica primero su correo. Revocar una invitación aceptada no anula una membresía; use los controles de membresía de comprador para revocar el acceso publicitario.

Reportar si esta instalación tiene una credencial usable.

agent status

Sin parámetros.

screenrig agent status

Solo lectura. Nunca cambia estado local o servidor, y no cuesta nada. El resultado lleva el access de la sesión, su effective_access y, cuando la configuración de revisión del proyecto o un miembro sin aprobación lo mantiene bajo, access_limited_by (project o person).

Inicie sesión en esta instalación con una cuenta existente, con la aprobación de una persona en el panel.

login [--project ID] [--access read|propose|manage] [--name NAME] [--no-wait] [--resume ID]

screenrig login --access read

Imprime la dirección del panel y un código de ocho letras en stderr, luego espera hasta 24 horas. La persona verifica que el código coincida y presiona Conectar una vez, sin segunda solicitud de passkey tras un inicio de sesión en el panel en la última hora. El sobre informa status: signed_in, el proyecto, la organización y access. Ejecutarlo de nuevo en una instalación con sesión iniciada añade un proyecto o eleva un proyecto de Solo lectura o Proponer a Gestionar. La denegación es login_denied y la expiración es login_expired.

Finalizar la sesión de esta instalación y eliminar sus tokens.

logout

Sin parámetros.

screenrig logout

Revoca el inicio de sesión en el servidor, luego elimina los tokens almacenados e informa status: signed_out. Un fallo que podría no haber llegado al servidor los mantiene, por lo que volver a ejecutar es seguro. Ejecute screenrig login para iniciar sesión nuevamente.

Abra la URL ordinaria del panel. Este comando no genera un enlace de inicio de sesión, crea una sesión ni necesita credencial de agente.

dashboard [open]

screenrig dashboard

El dashboard muestra los proyectos de la persona después de iniciar sesión. La selección de proyecto en el navegador no cambia el proyecto vinculado a un agente.

Solicitar un correo electrónico de restablecimiento de inicio de sesión sin credencial de agente.

dashboard reset-sign-in --email ADDRESS

El acuse no revela si el correo tiene inicio de sesión. El restablecimiento enviado por correo expira en una hora; la persona crea una nueva passkey. La finalización reemplaza sus credenciales de inicio de sesión y revoca otras sesiones.

Verifique esta instalación e informe cada verificación por nombre.

doctor [--repair-config]

screenrig doctor

data.checks nombra cada verificación y su estado: el runtime de Node, la ruta de configuración resuelta y sus permisos, el origen del plano de control y sus rutas de servicio, la capacidad feedback anunciada, y la cadena de herramientas multimedia opcional (ffmpeg, ffprobe, encoder_libx264, encoder_libx265, encoder_libwebp, cwebp, filter_hdr_tonemap).

Cualquier verificación fallida hace que doctor salga con código distinto de cero, así que lea los nombres individuales antes de marcar la instalación como no saludable. Una cadena de herramientas de medios faltante afecta solo a media upload.

Imprima la versión del CLI incluida y su adaptador de protocolo.

version

Sin parámetros.

screenrig version

Ejecute esto primero en una sesión. Un sobre exitoso prueba que el lanzador resolvió la CLI incluida. --version y -V hacen lo mismo desde cualquier línea de comandos.

Listar los clientes de servicio de este proyecto, activos y revocados, con sus claves, IDs secretas y uso.

service-client list

Sin parámetros.

screenrig service-client list

Nunca devuelve un secreto.

Mostrar un cliente de servicio.

service-client show ID

screenrig service-client show scl_ID

Lista el kid de cada clave y el css_ de cada secreto para rotación.

Crear un cliente de servicio propiedad de este proyecto.

service-client create --name NAME [--capability NAME]... [--access read|propose|manage] [--key-file PATH] [--secret-file PATH]

screenrig service-client create --name "Nightly report" --access read --capability reports --key-file screenrig-client.pem

Requiere las autorizaciones de identidad, proyecto y administración de la organización descritas arriba. Máximo 50 clientes activos por organización, contados en todos sus proyectos. Una clave sin su propio kid se identifica mediante su huella RFC 7638.

Registrar una segunda clave pública para una rotación sin tiempo de inactividad.

service-client add-key ID --key-file PATH

screenrig service-client add-key scl_ID --key-file new.pem

Un cliente tiene como máximo dos claves.

Generar un segundo secreto para una rotación sin tiempo de inactividad.

service-client add-secret ID --secret-file PATH

screenrig service-client add-secret scl_ID --secret-file new-secret

Un cliente tiene como máximo dos secretos. El actual sigue funcionando hasta que lo elimine.

Eliminar una clave; los tokens emitidos con ella dejan de funcionar en segundos.

service-client remove-key ID --kid KID

screenrig service-client remove-key scl_ID --kid KID

Un cliente mantiene al menos una clave o secreto.

Eliminar un secreto; los tokens emitidos con él dejan de funcionar en segundos.

service-client remove-secret ID --secret-id css_ID

screenrig service-client remove-secret scl_ID --secret-id css_ID

Revocar un cliente de servicio permanentemente.

service-client revoke ID --yes

screenrig service-client revoke scl_ID --yes

Elimina sus claves y secretos; sus tokens dejan de funcionar en segundos. El registro permanece para auditoría.

Generar una imagen fija presentable de página completa en la tienda de medios del proyecto.

media generate --prompt TEXT [--aspect-ratio RATIO] [--quality low|medium|high] [--tag TAG]
               [--no-progress]

screenrig media generate --prompt "A 16:9 restaurant menu poster for North Lobby Cafe. Dark walnut, gold type. Title NORTH LOBBY CAFE. Items: Espresso $4, Cortado $4.50, House Blend $3. Footer Open 7am to 7pm. Typeset every line of copy in the image." --aspect-ratio 16:9 --quality high --tag LobbyMenu

El comando almacena un WebP con pérdida en la tienda de medios del proyecto y devuelve data.media_id (med_…). No vuelva a subir los bytes. Nunca imprima píxeles ni el aviso. El árbol de autoría y el contrato del aviso viven en Compose.

Convierta un archivo local a bytes de entrega, cárguelo y espere hasta que el objeto esté listo.

media upload <file> [--content-type TYPE] [--tag TAG] [--folder ID] [--no-wait] [--poll-ms MS]
             [--timeout MS] [--no-transcode] [--codec h264|hevc] [--max-fps N]
             [--max-edge PIXELS] [--webp-quality 1-100] [--no-progress]
             [--preset signage-1080p30|signage-4k30] [--no-audio]

screenrig media upload ./lobby-welcome-loop.mp4 --tag LobbyLoop

El video se convierte en MP4: perfil alto H.264 nivel 4.2 por defecto, o H.265 con --codec hevc, en yuv420p etiquetado Rec. 709. Una fuente HDR se mapea a tono Rec. 709. El audio, si la fuente lo tiene, es AAC a 192 kbit/s, 48 kHz, estéreo.

Las imágenes fijas se convierten en WebP con pérdida a calidad 90, manteniendo el canal alfa donde la fuente lo tiene. Una fuente animada se repite indefinidamente. Un WebP que ya cumple con el límite de tamaño se pasa sin recodificar.

El audio se convierte en un MP3 para la banda sonora de la lista de reproducción. Una fuente MP3 se sube sin cambios; fuentes WAV, AAC, M4A, OGG y FLAC se convierten a MP3 de 128 kb/s, que requiere una compilación ffmpeg con libmp3lame. Una pista dura de 1 segundo a 3 horas. playlist init convierte entradas de audio en pistas de banda sonora en lugar de páginas. El objeto listo es un objeto multimedia audio con duración. No puede colocarse en una página; en la lista de reproducción, nómbrelo como banda sonora audio.

El id del objeto listo es data.media_id. El mismo valor es data.id y data.operation.result.media_id. Ese id es lo que toma un selector de lista de reproducción.

Un nombre de archivo con poca información como video.mp4 añade una advertencia generic_filename al sobre. La carga aún tiene éxito y la CLI nunca renombra el archivo; elija el nombre antes de ejecutar el comando.

La conversión ejecuta ffmpeg y ffprobe desde PATH, o desde las rutas absolutas en SCREENRIG_FFMPEG y SCREENRIG_FFPROBE. Las imágenes fijas prefieren el codificador ffmpeg libwebp y recurren a cwebp en PATH o SCREENRIG_CWEBP. Ejecute doctor antes de la primera carga de una sesión.

--preset signage-1080p30 limita el borde largo a 1920, el borde corto a 1080 y la tasa a 30 fps constante. signage-4k30 limita el borde largo a 3840, el borde corto a 2160 y la tasa a 30 fps constante. Ambos funcionan con contenido horizontal, vertical y cuadrado. --no-audio omite la codificación de audio para clips silenciosos. Estas opciones solo se aplican a video.

screenrig media upload ./lobby.mov --preset signage-1080p30 --no-audio

screenrig media upload ./menu.png --folder mfd_01EXAMPLEFOLDER000000000

La carga aterriza en la raíz de la biblioteca y se mueve a la carpeta una vez que está lista. media upload-batch --folder mueve cada elemento cargado de la misma manera.

Con acceso Proponer, o cuando el proyecto requiere revisión para cambios de agente, una nueva carga espera la revisión de una persona antes de que una etiqueta, carpeta o selector all la reproduzca; vea Revisiones.

Suba muchos archivos locales desde un manifiesto, reanudando desde un archivo de estado requerido.

media upload-batch <manifest.json> [--state FILE] [--concurrency N] [--tag TAG] [--folder ID]
                   [--poll-ms MS] [--timeout MS] [--no-transcode] [--codec h264|hevc]
                   [--max-fps N] [--max-edge PIXELS] [--webp-quality 1-100] [--no-progress]
                   [--preset signage-1080p30|signage-4k30] [--no-audio]

screenrig media upload-batch ./images.json --state ./upload-state.json

El sobre lleva data.items[] en orden de manifiesto, cada uno con path, source_filename, sha256, outcome (accepted o resumed), y media_id. data.failed[] lleva elementos que no se entregaron.

Reemplazar el archivo de un contenido multimedia en el sitio. Su ID, sus listas de reproducción y sus programaciones siguen funcionando.

media replace <id> <file> [--expect-rev REVISION] [--note TEXT] [--content-type TYPE] [--no-wait]
              [--poll-ms MS] [--timeout MS] [--no-transcode] [--codec h264|hevc] [--max-fps N]
              [--max-edge PIXELS] [--webp-quality 1-100] [--no-progress]
              [--preset signage-1080p30|signage-4k30] [--no-audio]

screenrig media replace med_01EXAMPLEIMAGE0000000000 ./menu-v2.png
screenrig media replace med_01EXAMPLEVIDEO0000000000 ./intro.mp4 --expect-rev 3 --note "Spring cut"

El contenido multimedia conserva su ID, sus etiquetas y su carpeta, de modo que cada lista de reproducción y programación que lo nombra reproduce el archivo nuevo en el siguiente manifiesto, y los selectores de etiqueta, carpeta y all también lo recogen. No se reprograma nada. El comando ejecuta los mismos pasos que media upload (conversión, límite de bytes de vídeo del plan, límites de dimensiones, cuota de almacenamiento, transferencia firmada) y luego reemplaza en lugar de añadir contenido multimedia nuevo. No admite --tag ni --folder.

De forma predeterminada el comando espera al procesamiento. data.media_id y data.id son el ID del contenido multimedia, data.version es el número del nuevo archivo en media versions, y data.revision es la nueva revisión del contenido multimedia. data.warnings, data.operation, data.upload, data.transcode y la temporización se informan como en media upload, y el ID de la operación está en el sobre. Con --no-wait, data.operation es la operación aceptada, y data.version y data.warnings no aparecen.

Se permite un cambio de relación de aspecto. El sobre incluye una advertencia aspect_ratio_changed, y data.warnings[].playlists nombra las listas de reproducción que usan el contenido multimedia, así que compruebe cómo se ven. Un archivo con los mismos bytes que el actual se rechaza con resource_conflict (código de salida 13).

Cada archivo anterior permanece en el historial del contenido multimedia y cuenta en los bytes almacenados hasta que se elimine su versión; vea media versions.

Con acceso Propose, o cuando el proyecto requiere revisión para los cambios de agente, el reemplazo espera a una persona y el comando tiene éxito (código de salida 0): data.status es pending_review, data.review_id nombra la revisión, la advertencia pending_review da su URL y data.next es screenrig reviews show ID. El contenido multimedia sigue reproduciendo su archivo actual hasta que una persona apruebe, así que dígale que está esperando y no repita la escritura. Un reemplazo más reciente del mismo contenido multimedia sustituye al que espera. Vea Revisiones.

Enumera los archivos que ha tenido un contenido multimedia, con el archivo en uso primero.

media versions <id> [--limit N] [--cursor CURSOR]

screenrig media versions med_01EXAMPLEIMAGE0000000000

data.items tiene una entrada por cada archivo que ha tenido el contenido multimedia: number, current, filename, content_type, sha256, bytes, width, height, duration_ms, codecs, source (upload, replace, sync o restore), note, by (tipo person, agent, client o sync, con ID y nombre) y restored_from. El archivo en uso va primero (current: true), después los demás del más reciente al más antiguo. La versión 1 es la primera carga; cada reemplazo, restauración o cambio de sincronización de multimedia añade el número siguiente.

Sin --limit ni --cursor se leen todas las páginas y data.next_cursor es null. Con cualquiera de los dos, se lee una página: mientras data.next_cursor sea una cadena, ejecute de nuevo el comando con --cursor establecido en ese valor. Basta con acceso de solo lectura. Los bytes de una versión anterior siguen almacenados y cuentan en los bytes almacenados del proyecto hasta que media version delete los elimine; no hay límite en cuántas versiones se conservan, y los bytes almacenados por encima del almacenamiento gratuito del plan se facturan como cualquier otro almacenamiento.

Volver a poner en uso una versión anterior como nueva versión.

media restore <id> --number N [--expect-rev REVISION] [--note TEXT]

screenrig media restore med_01EXAMPLEIMAGE0000000000 --number 2
screenrig media restore med_01EXAMPLEIMAGE0000000000 --number 2 --expect-rev 5 --note "Back to the winter menu"

El contenido multimedia conserva su ID y pasa a una nueva revisión, y cada lista de reproducción y programación que lo nombra vuelve a reproducir ese archivo. La versión que copia permanece en el historial y comparte sus bytes; la nueva versión cuenta en los bytes almacenados como cualquier otra. data.media es el contenido multimedia y data.warnings incluye aspect_ratio_changed, que nombra las listas de reproducción que usan el contenido multimedia, cuando el archivo restaurado tiene otra relación de aspecto.

La versión en uso no se puede restaurar (resource_conflict, código de salida 5), y una versión desconocida es not_found (código de salida 4). Con acceso Propose, o cuando el proyecto requiere revisión para los cambios de agente, la restauración espera a una persona y el comando tiene éxito (código de salida 0): data.status es pending_review con data.review, la advertencia pending_review da su URL y data.next es screenrig reviews show ID. El contenido multimedia sigue reproduciendo su archivo actual hasta que una persona apruebe, así que no repita la escritura.

Eliminar una versión anterior y sus bytes almacenados.

media version delete <id> --number N

screenrig media version delete med_01EXAMPLEIMAGE0000000000 --number 2

El registro de la versión desaparece y sus bytes salen de inmediato de los bytes almacenados del proyecto. El objeto almacenado se elimina tras 24 horas, salvo que otra versión o el archivo en uso contenga el mismo archivo. Una versión eliminada no se puede restaurar. La versión en uso no se puede eliminar, y ninguna versión se puede eliminar mientras un reemplazo del contenido multimedia espera revisión; ambos casos son resource_conflict (código de salida 5), y media versions ID muestra qué versión está en uso. Una versión desconocida es not_found (código de salida 4). Eliminar requiere acceso Manage: una credencial Propose se rechaza con insufficient_access, y la eliminación nunca se propone para revisión.

Lea un objeto multimedia, incluida su revisión actual.

media show <id>

screenrig media show med_01EXAMPLEIMAGE0000000000

Escriba una versión almacenada en disco para inspección. Nunca imprima los bytes.

media download <id> [--output FILE]

screenrig media download med_01EXAMPLEIMAGE0000000000 --output ./lobby.webp

El sobre informa media_id, path, bytes, sha256, content_type, primitive, filename, opcional source_filename, y width / height. Nunca lleva píxeles. Use esto para verificar una imagen generada antes de que se muestre en pantalla.

Listar objetos multimedia, opcionalmente filtrados por etiqueta y primitivo.

media list [--tag TAG] [--primitive image|video|audio] [--folder ID|root] [--library]

screenrig media list --tag LobbyLoop --primitive video
screenrig media list --folder mfd_01EXAMPLEFOLDER000000000
screenrig media list --library

Cada fila lleva folder_id, que está ausente en la raíz de la biblioteca.

Cambiar o borrar la etiqueta en un objeto. Su regla de disponibilidad se define con media availability.

media update <id> (--tag TAG | --tags TAG1,TAG2 | --clear-tag) [--expect-rev REVISION]

screenrig media update med_01EXAMPLEIMAGE0000000000 --tag LobbyLoop

Con acceso Proponer, o cuando el proyecto requiere revisión para cambios de agente, volver a etiquetar multimedia aprobado responde ok con advertencia media_review_pending: las pantallas siguen reproduciéndolo con sus etiquetas aprobadas hasta que una persona aprueba el cambio, y un rechazo restaura las etiquetas. Su revisión aparece en reviews list en segundos; un reetiquetado que no cambia ninguna playlist aprobada ni ninguna playlist en revisión se aplica solo. Vea Revisiones.

Define o borra cuándo los selectores dinámicos pueden elegir un archivo.

media availability <id> (--file FILE | --clear) [--expect-rev REVISION]

screenrig media availability med_01EXAMPLEIMAGE0000000000 --file rule.json

Los miembros y el comportamiento de la regla están en Disponibilidad de medios.

Eliminar un objeto multimedia.

media delete <id> [--expect-rev REVISION]

screenrig media delete med_01EXAMPLEIMAGE0000000000

Mueva archivos y carpetas multimedia a una carpeta, o de vuelta a la raíz de la biblioteca.

media move <id>... (--folder ID | --root)

screenrig media move med_01EXAMPLEIMAGE0000000000 med_01EXAMPLEVIDEO0000000000 --folder mfd_01EXAMPLEFOLDER000000000
screenrig media move mfd_01EXAMPLEFOLDER000000000 --root

El movimiento es una solicitud de todo o nada. Una carpeta no puede moverse dentro de sí misma ni dentro de una carpeta que contenga, y las carpetas se anidan a lo sumo 10 niveles. Los elementos ya en el destino permanecen como están. data.media y data.folders cuentan lo que se movió.

Mover archivos cambia lo que los selectores by:folder de sus carpetas antigua y nueva reproducen, desde la resolución del siguiente selector de cada pantalla; mover una carpeta no cambia los archivos propios de ninguna carpeta. Bajo Propose access, o cuando el proyecto requiere revisión para cambios de agente, cada archivo movido espera la revisión de una persona (reviews list) y las listas de reproducción aprobadas siguen reproduciéndolo por la carpeta con la que fue aprobado; vea Reviews.

Listar las carpetas multimedia del proyecto.

media folder list [--library]

screenrig media folder list
screenrig media folder list --library

Devuelve todas las carpetas del proyecto, hasta 1000, ordenadas por nombre: data.items con id, name, parent_id (null en la raíz de la biblioteca) y revision. Construya el árbol a partir de parent_id. La carpeta de un archivo es folder_id en media list y media show; está ausente en la raíz de la biblioteca.

Lea una carpeta de medios.

media folder show <id>

screenrig media folder show mfd_01EXAMPLEFOLDER000000000

El sobre lleva el name, parent_id y revision de la carpeta.

Crear una carpeta de medios en la raíz de la biblioteca o dentro de otra carpeta.

media folder create --name NAME [--parent ID]

screenrig media folder create --name Menus
screenrig media folder create --name Lunch --parent mfd_01EXAMPLEFOLDER000000000

Una organización contiene como máximo 1000 carpetas en todos sus proyectos, anidadas hasta 10 niveles de profundidad. Una lista de reproducción reproduce los archivos de una carpeta con un selector by:folder.

Renombrar una carpeta de multimedia o moverla con todo su contenido a otra carpeta.

media folder update <id> [--name NAME] [--parent ID | --root] [--expect-rev REVISION]

screenrig media folder update mfd_01EXAMPLEFOLDER000000000 --name Archive
screenrig media folder update mfd_01EXAMPLEFOLDER000000000 --root

Una carpeta no puede moverse dentro de sí misma ni dentro de una carpeta contenida en ella, y un movimiento debe mantener todas las carpetas dentro de 10 niveles. Enviar los valores actuales no hace nada.

Eliminar una carpeta de multimedia. Sus archivos y carpetas se mueven un nivel arriba.

media folder delete <id> [--expect-rev REVISION]

screenrig media folder delete mfd_01EXAMPLEFOLDER000000000

Elimina solo la carpeta. Sus archivos y carpetas se mueven al padre, o a la raíz de la biblioteca si no tiene. Un selector by:folder que la nombre ya no coincide con nada, así que redirija esas listas de reproducción primero.

Agrega su propia aplicación de Microsoft Entra, o una conexión de Microsoft del proyecto, para que una sincronización pueda leer una carpeta de SharePoint o de OneDrive para el trabajo.

media sync account add microsoft365 --name NAME
    (--tenant-id TENANT --client-id ID --secret-file FILE | --connection-id ID)

screenrig media sync account add microsoft365 --name Contoso --tenant-id contoso.onmicrosoft.com --client-id 0b1d2f3a-4c5e-4f60-8a7b-9c0d1e2f3a4b --secret-file secret.txt
screenrig media sync account add microsoft365 --name Contoso --connection-id pcn_01EXAMPLECONNECTION0000

En el centro de administración de Microsoft Entra, registre una aplicación de un solo tenant sin URI de redirección, agregue un secreto de cliente (copie su valor, no su ID de secreto), agregue el permiso de aplicación de Microsoft Graph Sites.Selected (y luego conceda a la aplicación acceso de lectura a cada sitio) o Files.Read.All, y conceda el consentimiento del administrador. La aplicación pertenece a este proyecto. Ejecute media sync account test a continuación.

Agrega una cuenta de Dropbox e imprime el enlace de un solo uso que su propietario abre, con la sesión iniciada en Dropbox, para conectarla.

media sync account add dropbox --name NAME [--app-key KEY]

screenrig media sync account add dropbox --name "Marketing Dropbox"
screenrig media sync account add dropbox --name "Marketing Dropbox" --app-key YOURAPPKEY

data.authorize_url es el enlace y data.authorize_expires_at su caducidad. La CLI nunca abre un navegador: envíe el enlace a la persona propietaria de la cuenta de Dropbox, que permite el acceso de solo lectura (files.metadata.read, files.content.read, account_info.read). Ejecute media sync account show hasta que data.state sea ready (empieza como pending_consent) y después media sync create dropbox. Su propia aplicación de Dropbox necesita esos permisos habilitados y el URI de redirección que muestra la salida.

Agrega una cuenta de Google Drive, lista de inmediato, e imprime la dirección de la cuenta de servicio con la que se comparten las carpetas.

media sync account add google-drive --name NAME [--key-file FILE]

screenrig media sync account add google-drive --name "Marketing Drive"
screenrig media sync account add google-drive --name "Marketing Drive" --key-file key.json

data.config.service_account_email es la dirección con la que compartir cada carpeta; basta con el rol Lector. Con la cuenta de servicio de screenRIG, una carpeta se sincroniza solo cuando un miembro de este proyecto con un correo electrónico verificado la compartió o es su propietario (de lo contrario, media_sync_sharer_not_member). Con su propia clave, se sincroniza cualquier carpeta compartida con la cuenta de servicio.

Lista las cuentas de sincronización de medios de este proyecto con su tipo, estado y última prueba; no se devuelve ningún secreto.

media sync account list

Sin parámetros.

screenrig media sync account list

Inspecciona una cuenta: su tenant y su ID de cliente, el estado, el secreto enmascarado y la última prueba.

media sync account show <id>

screenrig media sync account show msa_01EXAMPLEACCOUNT0000000

Una cuenta de Dropbox muestra además quién la conectó y su app_key; una cuenta de Google Drive muestra su service_account_email.

Cambia el nombre de una cuenta, el tenant, el ID de aplicación o el secreto de cliente de una aplicación de Microsoft, o sustituye la clave propia de una cuenta de Google Drive.

media sync account update <id> [--name NAME] [--tenant-id TENANT] [--client-id ID]
    [--secret-file FILE | --key-file FILE] [--expect-rev REVISION]

screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --secret-file new-secret.txt
screenrig media sync account update msa_01EXAMPLEACCOUNT0000000 --name "Contoso tenant" --expect-rev 2

Se requiere al menos un cambio. Un cambio de credenciales borra last_test: pruebe la cuenta de nuevo. Los secretos de cliente de Entra caducan, así que reemplace aquí el secreto antes de que caduque.

Genera un nuevo enlace de un solo uso para conectar, o reconectar, una cuenta de Dropbox.

media sync account connect <id>

screenrig media sync account connect msa_01EXAMPLEACCOUNT0000000

data.authorize_url y data.authorize_expires_at llevan el enlace, que sustituye al anterior. Envíelo a la persona propietaria de la cuenta de Dropbox. Úselo cuando la persona no haya terminado o la cuenta esté en reconnect_required (Dropbox ya no acepta la conexión). Una cuenta conectada sigue conectada hasta que se completa el nuevo consentimiento, y otra cuenta de Dropbox que inicie sesión se queda con la conexión.

Comprueba una cuenta: el inicio de sesión y los permisos de Graph de una aplicación de Microsoft, o la conexión o la clave de una cuenta de Dropbox o de Google Drive.

media sync account test <id>

screenrig media sync account test msa_01EXAMPLEACCOUNT0000000

La respuesta se guarda como last_test. Para una aplicación de Microsoft informa de credentials (Microsoft emitió un token; un rechazo lleva su código AADSTS, como AADSTS7000215 cuando el secreto es el ID en lugar del valor) y permissions (los permisos de aplicación de Graph que lleva el token). Sites.Selected por sí solo es una advertencia: cada sitio sigue necesitando su concesión, y un enlace para compartir necesita Files.Read.All. La prueba no juzga la concesión de un sitio ni una carpeta: media sync create lee la carpeta que usted indica. Una comprobación fallida es data.ok false con salida 0.

Elimina una cuenta que ninguna sincronización usa.

media sync account delete <id> [--expect-rev REVISION]

screenrig media sync account delete msa_01EXAMPLEACCOUNT0000000

Mientras haya sincronizaciones que usen la cuenta, la respuesta es resource_conflict (salida 5), que las nombra: elimínelas primero.

Sincroniza una carpeta de SharePoint o de OneDrive para el trabajo en una carpeta de medios.

media sync create sharepoint --account-id ID --url URL [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url https://contoso.sharepoint.com/sites/Marketing/Shared%20Documents/Lobby%20Signs
screenrig media sync create sharepoint --account-id msa_01EXAMPLEACCOUNT0000000 --url "https://contoso.sharepoint.com/:f:/s/Marketing/EabcDEF" --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

Una carpeta que Microsoft rechaza da media_sync_source_refused (salida 5), con el permiso que hay que conceder; no se guarda nada.

Sincroniza una carpeta de Dropbox en una carpeta de medios.

media sync create dropbox --account-id ID --url URL|PATH [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url https://www.dropbox.com/home/Marketing/Lobby%20Signs
screenrig media sync create dropbox --account-id msa_01EXAMPLEACCOUNT0000000 --url /Marketing/Lobby --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h --name "Lobby signs"

Cada ejecución continúa desde la posición guardada de Dropbox en la carpeta y lee solo lo que cambió. Una carpeta que la cuenta no puede abrir da media_sync_source_refused, y una conexión que Dropbox ya no acepta da dropbox_reconnect_required (media sync account connect): ambas con salida 5, sin guardar nada.

Sincroniza una carpeta de Google Drive compartida con la cuenta de servicio de una cuenta en una carpeta de medios.

media sync create google-drive --account-id ID --url URL|ID [--folder-id ID] [--every DURATION] [--name NAME]

screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrStUvWxYz --folder-id mfd_01EXAMPLEFOLDER000000000 --every 1h
screenrig media sync create google-drive --account-id msa_01EXAMPLEACCOUNT0000000 --url 1AbCdEfGhIjKlMnOpQrStUvWxYz

Con la cuenta de servicio de screenRIG, la carpeta se sincroniza solo cuando un miembro de este proyecto con un correo electrónico verificado la compartió o es su propietario (media_sync_sharer_not_member, salida 3, no se guarda nada). Cada ejecución lo comprueba de nuevo, y una carpeta que se queda sin esa persona que la compartía detiene la sincronización en estado error conservando sus medios: vuelva a compartirla desde la cuenta de Google de un miembro y después ejecute media sync update ID --resume. Los archivos de Google Docs, Sheets y Slides se omiten como unsupported_type. Una carpeta que la dirección no puede abrir da media_sync_source_refused (salida 5): compártala con la cuenta de servicio.

Lista las sincronizaciones de medios de este proyecto con su carpeta de medios, cadencia, estado y estado de la última ejecución.

media sync list

Sin parámetros.

screenrig media sync list

Inspecciona una sincronización y el resumen de su última ejecución.

media sync show <id>

screenrig media sync show msy_01EXAMPLESYNC000000000

data.last_run lleva status (ok, partial o error), added, updated, removed, pending_delete (archivos eliminados que una pantalla aún conserva, a la espera en la carpeta Removed) y skipped con el motivo de cada archivo (unsupported_type, too_large, storage, subfolder, download_failed, unreadable, in_use); una ejecución fallida lleva error con un code y un detail que indican la solución. data.source añade path para Dropbox y shared_by para Google Drive.

Una sincronización en estado error necesita una reparación. Se eliminó su carpeta de medios: apúntela a otra con media sync update --folder-id. Se eliminó o movió su carpeta de origen: elimine la sincronización y cree otra. Para Google Drive con la cuenta de servicio de screenRIG, la carpeta se quedó sin una persona verificada que la comparta (sharer_not_member): vuelva a compartirla desde la cuenta de Google de un miembro del proyecto y después media sync update ID --resume. Una ejecución de Dropbox falla con reconnect_required cuando Dropbox deja de aceptar la conexión (media sync account connect).

Cambia el nombre, la cadencia o la carpeta de medios de una sincronización, o la pausa y la reanuda.

media sync update <id> [--name NAME] [--every DURATION] [--folder-id ID]
    [--pause | --resume] [--expect-rev REVISION]

screenrig media sync update msy_01EXAMPLESYNC000000000 --every 1h
screenrig media sync update msy_01EXAMPLESYNC000000000 --pause
screenrig media sync update msy_01EXAMPLESYNC000000000 --folder-id mfd_01EXAMPLEFOLDER000000000 --expect-rev 3

Se requiere al menos un cambio.

Ejecuta una sincronización ahora en lugar de a su próxima hora.

media sync run <id>

screenrig media sync run msy_01EXAMPLESYNC000000000

La sincronización se ejecuta en unos 30 segundos, y media sync show muestra entonces su última ejecución. Una sincronización en pausa debe reanudarse antes.

Detiene una sincronización; sus medios y su carpeta permanecen.

media sync delete <id> [--expect-rev REVISION]

screenrig media sync delete msy_01EXAMPLESYNC000000000

La sincronización olvida qué archivo de origen se convirtió en qué medio. Los medios importados y la carpeta de medios permanecen, y no se elimina nada.

Empaque un directorio estático en un archivo determinista sin subirlo.

app pack <directory> [--output FILE]

screenrig app pack ./lobby-board --output ./lobby-board.tgz

El sobre informa sha256, compressed_bytes, expanded_bytes, file_count, la lista de entradas y si se inyectó el tiempo de ejecución del SDK. app upload empaqueta el directorio mismo, así que use este comando solo cuando quiera inspeccionar primero el archivo.

Las aplicaciones se ejecutan bajo una política de seguridad de contenido que bloquea código en línea. El empaquetado mueve bloques de estilo y script en línea a archivos bajo _screenrig/inline/ y los enlaza. Los manejadores de eventos en línea como onclick= y URLs javascript: no pueden moverse; el empaquetado los rechaza y nombra el archivo y la línea.

Empaque un directorio, publíquelo como una nueva versión de la aplicación y espere a que la publicación tenga éxito.

app upload <directory> [--name NAME] [--no-wait] [--poll-ms MS] [--timeout MS]

screenrig app upload ./lobby-board --name "Lobby board"

Leer tres campos: data.operation.state es succeeded, data.application.release_id es el id rel_ un application primitivo pins, y data.application.id es el id app_ que toman los comandos kv. Una operación exitosa, no un id de lanzamiento por sí solo, significa que el lanzamiento es utilizable.

Cada app upload crea una nueva aplicación y un primer lanzamiento inmutable. Para publicar un lanzamiento posterior de la misma app, use app update. Una lista de reproducción sigue sirviendo el lanzamiento que ya fija hasta que edite ese primitivo.

Publicar una nueva versión de una aplicación existente, preservando identidad, nombre y K/V de la aplicación.

app update <id> <directory> [--expect-rev REVISION] [--no-wait] [--poll-ms MS]

screenrig app update app_01EXAMPLEAPP00000000000 ./lobby-board

Espere data.operation.state: "succeeded", luego use playlist replace-release para revisar la página exacta, el primitivo, la nueva versión y las pantallas afectadas. Aplique con el token de impacto devuelto y una protección de revisión opcional como se describe en el flujo de trabajo de la playlist. Los pines existentes de la playlist permanecen sin cambios hasta aplicar. En caso de conflicto de revisión, lea la aplicación nuevamente antes de decidir si reintentar; no cree una aplicación de reemplazo solo para evitar el conflicto.

Listar las aplicaciones del proyecto.

app list

Sin parámetros.

screenrig app list

Lea una aplicación.

app show <id>

screenrig app show app_01EXAMPLEAPP00000000000

latest_ready_release está ausente hasta que una primera publicación alcanza listo. El estado de publicación vive en la operación y el lanzamiento, no en la aplicación.

Eliminar una aplicación y todas sus versiones.

app delete <id> [--expect-rev REVISION]

screenrig app delete app_01EXAMPLEAPP00000000000

No hay eliminación por lanzamiento. Mientras una pantalla muestra una de las versiones de la aplicación, la eliminación responde application_in_use: primero dé a esas pantallas otro contenido. La eliminación no verifica listas de reproducción que fijan una versión sin mostrarla, así que actualice o elimine esas listas también.

Listar las claves almacenadas para una aplicación.

kv list --app-id ID

screenrig kv list --app-id app_01EXAMPLEAPP00000000000

Lea una clave.

kv get --app-id ID <key>

screenrig kv get --app-id app_01EXAMPLEAPP00000000000 menu

Escriba una clave desde JSON, un archivo o bytes base64.

kv set --app-id ID <key> --json-value JSON [--expect-rev REVISION]
kv set --app-id ID <key> --file FILE [--content-type TYPE] [--expect-rev REVISION]
kv set --app-id ID <key> --value-base64 BASE64 [--content-type TYPE] [--expect-rev REVISION]

screenrig kv set --app-id app_01EXAMPLEAPP00000000000 menu --json-value '{"soup":"lentil"}'

Eliminar una clave.

kv delete --app-id ID <key> [--expect-rev REVISION]

screenrig kv delete --app-id app_01EXAMPLEAPP00000000000 menu

Crear un webhook que escriba una clave, y recibir su URL y secreto una vez.

kv webhook create <key> --app-id ID [--description TEXT]

screenrig kv webhook create menu --app-id app_01EXAMPLEAPP00000000000 --description "Point of sale menu feed"

El sobre es el webhook: data.id (kvw_…), data.key, data.url (https://api.screenrig.ai/api/applications/<app_id>/kv-webhooks/<id>/write) y data.secret (srkw_…). Ingrese la URL y el secreto en el sistema de envío ahora. Ningún comando posterior muestra este secreto de nuevo.

Listar webhooks de una aplicación, las más antiguas primero.

kv webhook list --app-id ID

screenrig kv webhook list --app-id app_01EXAMPLEAPP00000000000

Cada elemento tiene id, key, description, url, created_at y, una vez que ha escrito, last_used_at. Una lista nunca contiene un secreto.

Eliminar un webhook. Su URL deja de funcionar de inmediato y la clave mantiene su valor.

kv webhook delete <webhook_id> --app-id ID

screenrig kv webhook delete kvw_01EXAMPLEWEBHOOK00000 --app-id app_01EXAMPLEAPP00000000000

Reemplazar el secreto de un webhook y recibir el nuevo una vez.

kv webhook rotate-secret <webhook_id> --app-id ID

screenrig kv webhook rotate-secret kvw_01EXAMPLEWEBHOOK00000 --app-id app_01EXAMPLEAPP00000000000

El sobre lleva el nuevo secreto en data.secret. El secreto antiguo deja de funcionar de inmediato, así que ingrese el nuevo en el sistema de envío.

Cambiar un webhook de tarjeta: su descripción, mapeo, estado activado o firma.

kv webhook update <webhook_id> --card CARD_ID [--description TEXT] [--map FILE|-] [--clear-map]
                   [--enable|--disable] [--signing|--no-signing]

screenrig kv webhook update kvw_01EXAMPLEWEBHOOK00000 --card crd_01EXAMPLEBOARD0000000000 --map alert-map.json

El sobre es el webhook. data.signing_secret aparece una sola vez, en la respuesta que activó la firma.

Leer el registro de entregas de un webhook de tarjeta, de lo más reciente a lo más antiguo, de los últimos siete días.

kv webhook deliveries <webhook_id> --card CARD_ID [--limit N]

screenrig kv webhook deliveries kvw_01EXAMPLEWEBHOOK00000 --card crd_01EXAMPLEBOARD0000000000

Cada elemento tiene at, outcome (written, unchanged, refused, invalid o handshake), reason (por ejemplo credentials, signature, disabled, body, mapping, card_data_invalid o rate_limited), detail, status, bytes, revision y request_id. No se almacena ningún cuerpo, encabezado ni credencial, y un envío a una dirección incorrecta no deja ninguna fila.

Prepare una lista de reproducción de pantalla completa editable a partir de archivos multimedia locales, ID de medios listos, ID de lanzamiento de aplicación o URL HTTP o HTTPS.

playlist init <inputs...> --name NAME --output FILE [--overwrite] [--screen-id ID]
              [--target-width PX --target-height PX] [--duration-ms MS] [--fit contain|cover|fill]
              [--no-transcode] [--no-progress] [--poll-ms MS]

screenrig playlist init med_POSTER med_VIDEO --name "Lobby loop" --screen-id scr_LOBBY --output lobby.json

La preparación escribe el documento local y puede subir medios; no crea una lista de reproducción remota ni asigna una pantalla. Inspeccione el documento, luego screen publish. Vea Preparar, publicar y editar listas de reproducción.

Valide un documento de lista de reproducción localmente antes de crear o actualizar. Sin red.

playlist validate <file>

screenrig playlist validate ./lobby-loop.json

Los errores nombran rutas JSON exactas. Un pase significa que la forma local y la semántica cruzada de campos son válidas; autorización, preparación de medios, conteos de selectores dinámicos, duraciones y disponibilidad remota aún requieren verificaciones del servidor. Crear y actualizar ejecutan esta verificación antes de escribir. El resultado también incluye hallazgos lint de geometría que no hacen fallar la verificación: motion_overuse, collision, safe_margin y adjacent_repeat. Para ver cómo se ve una página, publíquela y ejecute screen screenshot.

Crea una lista de reproducción a partir de un documento JSON, de una plantilla o de la plantilla integrada Aviso urgente.

playlist create [file] [--from-template ID --name NAME [--set NAME=VALUE...] [--dry-run]] [--starter KEY [--name NAME]] [--format-region REGION --format-orientation ORIENTATION] [--note TEXT]

screenrig playlist create ./lobby-loop.json

screenrig playlist create --from-template pl_01EXAMPLETEMPLATE00000 --name "Monday notice" --set headline="Open late"

data.id del sobre es el id pl_ que toma screen assign. Cuando el cambio espera revisión, data es {status: pending_review, review, playlist}: la lista existe con approved_revision: 0 y ninguna pantalla puede mostrarla hasta que una persona la apruebe (playlist_not_approved). Una plantilla es una lista que declara fields; nunca se muestra en una pantalla (playlist_is_template), y una lista creada a partir de ella es una lista normal que se puede asignar, programar y revisar.

Reemplazar un documento de lista de reproducción.

playlist update <id> <file> [--format-region REGION --format-orientation ORIENTATION] [--expect-rev REVISION] [--note TEXT]

screenrig playlist update pl_01EXAMPLEPLAYLIST000000 ./lobby-loop.json

Cuando el cambio espera revisión, la lista de reproducción en vivo sigue reproduciéndose sin cambios hasta que una persona aprueba la propuesta.

Lea una lista de reproducción, incluida su revisión actual.

playlist show <id>

screenrig playlist show pl_01EXAMPLEPLAYLIST000000

Devuelve la versión en vivo. approved_revision es 0 para una playlist que ninguna persona ha aprobado aún, y approval nombra la revisión abierta mientras un cambio espera; reviews show ID devuelve la propuesta.

Listar las playlists del proyecto.

playlist list [--templates] [--library]

screenrig playlist list --templates
screenrig playlist list --library

Muestra los campos de una plantilla o los valores de una copia, o cambia los valores y pone la copia al día.

playlist fields <id> [--set NAME=VALUE...] [--clear NAME...] [--refresh] [--expect-rev REVISION] [--note TEXT]

screenrig playlist fields pl_01EXAMPLECOPY00000000 --set headline="Closed today"

Sin opciones muestra los campos de una plantilla y cuántas listas se crearon a partir de ella, o los valores de una copia, la revisión de la plantilla con la que se creó y si la plantilla tiene una más reciente. Cada cambio, y --refresh solo, vuelve a crear las páginas de la copia con la revisión actual de la plantilla, que es como un cambio de marca hecho en la plantilla llega a las copias existentes; nada se envía a ellas por sí solo. Los valores se comprueban como al crear. Con acceso Propose, un cambio se convierte en una revisión.

Lista las listas de reproducción creadas a partir de una plantilla y la revisión de la plantilla con la que se creó cada una.

playlist instances <id>

screenrig playlist instances pl_01EXAMPLETEMPLATE00000

outdated marca una lista de reproducción creada con una revisión anterior de la plantilla; playlist fields ID --refresh la pone al día.

Listar las revisiones de una playlist, la más reciente primero.

playlist revisions <id> [--after CURSOR]

screenrig playlist revisions pl_01EXAMPLEPLAYLIST000000

Cada revisión indica qué la creó (created, edited, promoted con la revisión que copió, o baseline, la revisión que tenía la playlist cuando empezó su historial), quién la hizo, cuándo, cuántas páginas tiene y si es la actual. Una página contiene 50 revisiones; next_cursor lee la siguiente.

Leer una revisión y la playlist tal como estaba en ella.

playlist revision show <id> --revision N

screenrig playlist revision show pl_01EXAMPLEPLAYLIST000000 --revision 3

Volver a hacer actual una revisión anterior copiándola como una nueva revisión.

playlist promote <id> --revision N --expect-rev CURRENT

screenrig playlist promote pl_01EXAMPLEPLAYLIST000000 --revision 3 --expect-rev 9

Las páginas, la banda sonora y el formato de la revisión pasan a ser la siguiente revisión. El nombre se mantiene, las revisiones anteriores siguen en la lista y cada pantalla que muestra la playlist se actualiza. Promover requiere una credencial que publique en vivo; una cuyos cambios esperan revisión recibe forbidden. Una revisión cuyo contenido ya es el actual no cambia nada.

Eliminar una lista de reproducción.

playlist delete <id> [--expect-rev REVISION]

screenrig playlist delete pl_01EXAMPLEPLAYLIST000000

Exporta archivos de imagen y vídeo, audio de la banda sonora y URL de iframe como un paquete portátil de lista de reproducción.

playlist export <id> --output DIRECTORY [--skip-applications]

screenrig playlist export pl_01EXAMPLEPLAYLIST000000 --output ./lobby-bundle

El paquete contiene un manifiesto, el documento de la lista de reproducción y archivos de imagen, vídeo y audio de la banda sonora direccionados por contenido. Los selectores dinámicos all, tag y folder se fijan en ID exactos, las URL de iframe se conservan y los comentarios se excluyen.

Las tarjetas, los flujos y las páginas adslot detienen la exportación antes de descargar los archivos multimedia. Las aplicaciones también la detienen de forma predeterminada; --skip-applications elimina las primitivas de aplicación y las páginas vacías o controladas por una aplicación, e informa de los ID de las primitivas y páginas omitidas. Debe quedar al menos una página. Las tarjetas, los flujos y las páginas adslot siguen deteniendo la exportación con esta opción.

Para obtener un documento editable que conserve las referencias a tarjetas y aplicaciones, usa screenrig playlist show pl_01EXAMPLEPLAYLIST000000 --output playlist.json. El documento utiliza recursos existentes del mismo proyecto.

Crear una lista de reproducción desde un directorio de paquete, o actualizar una existente desde él.

playlist import <directory> [--name NAME] [--update ID [--expect-rev REVISION] [--note TEXT]]

screenrig playlist import ./lobby-bundle
screenrig playlist import ./lobby-bundle --name "Lobby loop (copy)"

Los nombres para mostrar de listas de reproducción pueden repetirse. La importación crea una lista separada incluso cuando su nombre coincide; use --update con un ID para reemplazar una lista existente.

La importación valida todo el paquete localmente antes de tocar el proyecto: manifiesto, documento, rutas, tipos de medios, longitudes y hashes. Los medios existentes se reutilizan si coinciden exactamente en nombre de archivo, tipo de medio, longitud en bytes, hash y etiqueta; el resto se carga sin conversión, y la lista de reproducción se escribe solo después de que cada objeto está listo.

La importación nunca elimina ni poda medios remotos. Si un paso posterior falla después de que se haya iniciado una carga, el error lista los objetos confirmados como listos y dice si comenzó la escritura de la lista de reproducción. Reintentar el mismo paquete reutiliza esos objetos.

Empareje un Player con el código que aparece en su pantalla.

screenrig screen pair "$PAIRING_CODE" --name "Lobby"

Listar pantallas. Se omiten las pantallas archivadas a menos que se soliciten.

screen list [--state archived] [--tag TAG] [--folder ID|root]

screenrig screen list --tag Lobby
screenrig screen list --folder sfd_01EXAMPLEFOLDER000000000

Cada fila lleva el tags de la pantalla. Con --human, la tabla agrega una columna TAGS cuando alguna pantalla listada tiene etiquetas.

Lea una pantalla, incluida revisión, asignación y estado en vivo.

screen show <id>

screenrig screen show scr_01EXAMPLESCREEN00000000

tags lista las etiquetas de la flota de la pantalla. effective_playlist, takeover y playlist_schedule informan qué reproduce la pantalla y por qué; vea Programaciones y takeover. health y las capacidades del host del Player están en Salud y energía del dispositivo. online es verdadero mientras un Player está conectado, incluyendo una breve ventana de reconexión. last_online_at y last_ip opcionales aparecen después de la primera conexión. observation opcional informa las superficies que un Player ha pintado: id, width, height, pixel_ratio y presentation. Todos estos son solo lectura; screen update no puede enviarlos, y una pantalla archivada aún devuelve su fila.

commands lista los últimos 10 reinicios, recargas, vaciados de caché, reinicios de aplicación y actualizaciones de la pantalla, los más antiguos primero, cada uno con su type, su state (queued, sent, done, failed, expired, cancelled o superseded), su source (schedule para un reinicio emitido por una programación de reinicio; ausente en uno solicitado por una persona), su expires_at y el momento en que se envió o se completó. reboot_schedule y next_reboot_at informan de la programación de reinicio de la pantalla y del inicio de su próxima ventana de reinicio. Un vaciado de caché, un reinicio de aplicación o una actualización que terminó el Player lleva además su cause y un detail breve, que --human imprime como columna CAUSE y como línea bajo la tabla. suspension lleva message y since de una pantalla suspendida. Una pantalla archivada por screen replace informa replaced_by, la pantalla a la que se movió su dispositivo. Con --human, screen show imprime cada uno.

last_outage informa de la última caída de la pantalla: offline_since, back_at y duration_s y, cuando un informe de estado la determina, una likely_cause de device_restart, app_crash, app_restart, network o platform; no aparece cuando screenRIG no puede determinarla. Un reinicio se determina al volver la pantalla, mientras que una causa de red o de screenRIG espera al siguiente informe de estado del Player, que puede tardar hasta quince minutos. glass contiene los veredictos que screenRIG sacó de los informes de reproducción y las capturas de pantalla. Con --human, screen show imprime Last outage y Likely cause, y Playlist stalled, Blank screen o Frozen picture para un veredicto que encontró un problema; Notificaciones explica qué dejan fuera los veredictos.

Parche el nombre de una pantalla, asignación de lista de reproducción o zona horaria en una sola llamada.

screen update <id> [--name NAME] [--playlist-id ID] [--timezone ZONE] [--expect-rev REVISION]

screenrig screen update scr_01EXAMPLESCREEN00000000 --name "Lobby"

En revisión, un cambio solo de --playlist-id se propone como screen assign; una sesión Proponer no puede cambiar otros campos.

Crear una nueva lista de reproducción desde un archivo preparado y asignarla a una pantalla.

screen publish <id> <file> [--expect-rev REVISION] [--note TEXT]

screenrig screen publish scr_LOBBY lobby.json

Esto crea una nueva lista de reproducción y la asigna. No actualiza una lista de reproducción existente por nombre. Inspeccione primero el documento preparado. Repita la entrada idéntica para reanudar un fallo ambiguo. La lectura de la asignación no prueba la reproducción; solicite una captura de pantalla por separado. En revisión devuelve stage: pending_review con ambas revisiones. Vea Preparar, publicar y editar listas de reproducción.

Apunte una pantalla, o una flota de pantallas, a una lista de reproducción.

screen assign (<id>... | --tag TAG) --playlist-id ID [--expect-rev REVISION] [--note TEXT]

screenrig screen assign scr_01EXAMPLESCREEN00000000 --playlist-id pl_01EXAMPLEPLAYLIST000000
screenrig screen assign --tag Lobby --playlist-id pl_01EXAMPLEPLAYLIST000000

Si la lista de reproducción programa alguna página y la pantalla no tiene zona horaria, la CLI rechaza antes de enviar nada y nombra el comando screen set-timezone a ejecutar. Ninguna revisión se consume por ese rechazo. En una flota, cada pantalla aplica esa regla por sí misma: una pantalla sin zona horaria falla en su resultado y las otras se asignan.

Para publicar en una flota, cree la lista de reproducción una vez con playlist create, luego ejecute screen assign --tag TAG --playlist-id ID. screen publish apunta a una pantalla.

Establecer la zona horaria civil en la que se lee una lista de reproducción programada.

screen set-timezone <id> --timezone ZONE [--expect-rev REVISION]

screenrig screen set-timezone scr_01EXAMPLESCREEN00000000 --timezone America/Los_Angeles

Los horarios de página son tiempos civiles, por lo que no tienen sentido sin una zona. Cambiar la zona renueva la revisión del manifiesto.

Ocultar una pantalla y oscurecer su cristal.

screen archive <id> [--expect-rev REVISION]

screenrig screen archive scr_01EXAMPLESCREEN00000000

Archivar oculta la pantalla de la lista predeterminada y oscurece el vidrio. No desvincula el reproductor.

Restaurar una pantalla archivada a la lista predeterminada.

screen unarchive <id> [--expect-rev REVISION]

screenrig screen unarchive scr_01EXAMPLESCREEN00000000

Un Player también puede archivar su propia pantalla: un restablecimiento confirmado en un Player que tiene una clave, o desvincular un Player de navegador emparejado por cookie. screen show luego reporta archive_reason como device_reset o device_unpair (project para un archivo que usted solicita), con archived_at. La pantalla mantiene su vinculación de dispositivo por cualquier motivo, por lo que un Player que aún tiene esa clave o cookie de dispositivo permanece apagado y se reanuda al desarchivar sin necesidad de volver a emparejar. El Player que fue restablecido o desvinculado pierde su clave o cookie y se empareja nuevamente como una pantalla nueva. Una clave reemplazada por una recuperación confirmada de pantalla permanece retirada.

Una pantalla archivada como replaced por screen replace no mantiene ninguna vinculación de dispositivo, por lo que desarchivar la rechaza y screen delete la elimina.

Mostrar un aviso en una pantalla en lugar de su contenido, hasta que se reanude.

screen suspend <id> --message TEXT [--expect-rev REVISION]

screenrig screen suspend scr_01EXAMPLESCREEN00000000 --message "Closed for stocktake. Back at 9am."

Una pantalla suspendida muestra el mensaje en lugar de su contenido. Nada más cambia: su lista de reproducción, programación, toma de control y control de pantalla permanecen y siguen evolucionando, y screen resume muestra lo que la pantalla estaría mostrando ahora. screen show informa suspension con message y since; suspender una pantalla suspendida reemplaza el mensaje y mantiene since. Suspender aumenta la revisión de la pantalla, y el Player vuelve a obtener su manifiesto de inmediato. Una pantalla archivada responde screen_archived.

Finalizar la suspensión de una pantalla para que vuelva a mostrar su propio contenido.

screen resume <id> [--expect-rev REVISION]

screenrig screen resume scr_01EXAMPLESCREEN00000000

Reanudar muestra de nuevo el contenido propio de la pantalla, a partir de lo que la pantalla estaría mostrando ahora, y el Player vuelve a obtener su manifiesto de inmediato. Una pantalla que no está suspendida responde sin cambios, sin cambio de revisión. Una pantalla archivada responde screen_archived.

Eliminar una pantalla.

screen delete <id> [--expect-rev REVISION]

screenrig screen delete scr_01EXAMPLESCREEN00000000

Eliminar quita una pantalla solo mientras no haya ninguna clave de Player vinculada a ella, y screen show informa deletable: true para esa pantalla. Un Player que se empareja con un código, ya sea nativo o de navegador, tiene una clave, y la clave permanece vinculada a su pantalla, por lo que eliminar esa pantalla responde 409 screen_archive_required (código de salida 5): archívela en su lugar. Solo un Player de navegador emparejado por cookie no tiene clave, y su pantalla se elimina esté emparejada o aún pendiente.

Mover a esta pantalla el dispositivo emparejado como otra pantalla, manteniendo la configuración y el historial de esta pantalla.

screen replace <id> --with ID [--expect-rev REVISION]

screenrig screen replace scr_01EXAMPLESCREEN00000000 --with scr_01EXAMPLENEWSCREEN000000

Empareje primero el nuevo hardware como su propia pantalla y luego reemplace. La clave del dispositivo, o la credencial de un Player de navegador, ahora da acceso a <id>, que mantiene su nombre, etiquetas, zona horaria, lista de reproducción, programaciones, toma de control, horario de pantalla y su anulación, muro de video, comentarios, campos, ubicación e historial, y adopta el host y el Player del reemplazo. Su salud, estado, almacenamiento y comandos en cola empiezan de cero. La pantalla nombrada por --with se archiva con archive_reason replaced y replaced_by que nombra <id>. No mantiene ninguna vinculación de dispositivo, por lo que screen unarchive no puede restaurarla y screen delete la elimina. La clave que tenía <id> se retira tras una ventana de gracia de quince minutos, y después su dispositivo anterior es rechazado. Ambas pantallas deben estar activas y tener un Player emparejado: una pantalla que sigue esperando el emparejamiento responde resource_conflict, una archivada responde screen_archived, y un muro de video necesita un Player de reemplazo que declare display.wall (wall_unsupported). La solicitud siempre lleva una clave de idempotencia, y un reintento exacto devuelve la respuesta original.

Emitir un nuevo ID público para una pantalla.

screen rotate-public-id <id> [--expect-rev REVISION]

screenrig screen rotate-public-id scr_01EXAMPLESCREEN00000000

Crear el enlace de una pantalla, o reemplazarlo, e imprimir su URL de Player.

screen link create <id> [--expect-rev REVISION]

screenrig screen link create scr_01EXAMPLESCREEN00000000

Imprime data.url, la URL de Player (https://play.screenrig.ai/player/#screen=…) que se pega como URL de una fuente de navegador en vMix u OBS, que no conserva almacenamiento y de otro modo perdería su vinculación en cada carga. El Player se ejecuta desde la URL en cada carga: la URL es toda la vinculación. Crear el enlace de nuevo lo reemplaza (data.replaced es true): la URL anterior deja de funcionar de inmediato y el Player abierto desde ella muestra un aviso sin contenido. La URL es una credencial que abre la pantalla: se imprime bajo una etiqueta sensible, se mantiene fuera del registro de operaciones y screen link show la vuelve a mostrar. Ábrala en un solo lugar. Una pantalla que no se ha vinculado responde resource_conflict (código de salida 5), y una pantalla archivada responde screen_archived. Tras una solicitud interrumpida, vuelva a ejecutar el mismo comando: reutiliza la clave de idempotencia guardada y devuelve el mismo enlace.

Imprimir el enlace de una pantalla y su URL de Player.

screen link show <id>

screenrig screen link show scr_01EXAMPLESCREEN00000000

Imprime data.url bajo una etiqueta sensible con data.hint (los últimos cuatro caracteres del secreto), data.created_at y data.last_used_at una vez que un Player ha abierto el enlace. Una credencial solo lectura recibe url vacío con url_redacted true, y la salida humana indica que la URL se retiene; un inicio de sesión Manage la recibe. Una pantalla sin enlace responde screen_link_not_found (código de salida 4) y nombra el comando que crea uno. screen show imprime Screen link: on (…HINT) para una pantalla que lo tiene, y nunca su URL.

Desactivar el enlace de una pantalla.

screen link delete <id> [--expect-rev REVISION]

screenrig screen link delete scr_01EXAMPLESCREEN00000000

La URL deja de funcionar de inmediato y toda sesión que abrió termina: una fuente de navegador que aún la muestra presenta un aviso y ningún contenido hasta que se le da una URL nueva. La pantalla, su vinculación y su contenido no se tocan. Tiene éxito, sin cambiar nada, cuando la pantalla no tiene enlace.

Pida al reproductor de una pantalla, o a todos los reproductores de una flota, que recarguen una vez.

screen reload (<id>... | --tag TAG) [--expires-in DURATION] [--expect-rev REVISION]

screenrig screen reload scr_01EXAMPLESCREEN00000000
screenrig screen reload scr_01EXAMPLESCREEN00000000 --expires-in 2h
screenrig screen reload --tag Lobby

La respuesta lleva un reload_id, un state y un expires_at. A una pantalla en línea se le envía la recarga de inmediato (state sent); una pantalla sin conexión la mantiene como queued y se le envía cuando vuelve a estar en línea antes de expires_at, 24 horas después de la solicitud salvo que --expires-in indique otra cosa. Una recarga más reciente reemplaza a una que sigue en cola, screen show lista los commands de la pantalla y screen command cancel cancela una que sigue en cola. En una flota, el reload de cada resultado lleva el mismo state. Un Player web se recarga en su próximo límite de página; un Player nativo se reconecta, vuelve a obtener su manifiesto y verifica si hay una actualización. Un Player ignora una recarga dentro de los diez minutos posteriores a la última que actuó. La recarga funciona en pantallas activas y archivadas y no cambia la revisión de la pantalla.

Publique un mensaje transitorio como chrome de escenario en una pantalla activa o una flota.

screen toast (<id>... | --tag TAG) --text TEXT [--level info] [--duration-ms MS]

screenrig screen toast scr_01EXAMPLESCREEN00000000 --text "Lobby closed"
screenrig screen toast --tag Lobby --text "Closing in ten minutes"

Un toast no es un primitivo: no ocupa espacio en el lienzo, no tiene capa y no participa en la preparación ni en el fundido cruzado. Gana el último, no hay cola ni cancelación, y el sobre aceptado es solo { expires_at }. Nunca ponga credenciales u otro material secreto en el texto.

Mostrar el nombre de una pantalla sobre su contenido durante un tiempo, para encontrarla en el sitio.

screen identify <id> [--duration DURATION]

screenrig screen identify scr_01EXAMPLESCREEN00000000
screenrig screen identify scr_01EXAMPLESCREEN00000000 --duration 2m

El Player dibuja una superposición a pantalla completa sobre su contenido, con el nombre de la pantalla muy grande y su id pequeño debajo. La reproducción continúa detrás, y una identificación más reciente reemplaza la superposición. El sobre aceptado lleva identify_id, duration_ms y un expires_at 60 segundos después de la solicitud, por lo que una pantalla sin conexión nunca muestra la superposición más tarde. Solo un Player que declara la capacidad identify muestra la superposición: cualquier otra pantalla responde 409 identify_unsupported (código de salida 5) y no se envía nada, así que actualice el Player o muestre el nombre con screen toast. Una pantalla archivada responde screen_archived y una pantalla que sigue esperando el emparejamiento responde resource_conflict. La identificación no cambia la revisión de la pantalla.

Capture una imagen fija de una pantalla activa, o de cada pantalla en una flota, y guárdela en disco.

screen screenshot <id> [--output FILE] [--timeout MS] [--poll-ms MS]
screen screenshot (<id> <id>... | --tag TAG) [--output DIRECTORY] [--concurrency N] [--timeout MS] [--poll-ms MS]

screenrig screen screenshot scr_01EXAMPLESCREEN00000000 --output ./lobby.webp

screenrig screen screenshot --tag Lobby --output ./lobby-shots

El comando bloquea hasta que el WebP esté en disco; no hay --no-wait. El sobre informa screen_id, capture_id, path, bytes, sha256, width y height, y nunca bytes de imagen. Gana el último: una solicitud posterior reemplaza una captura en curso. Una captura de pantalla del Player web dibuja cada página iframe como un recuadro gris oscuro con la etiqueta «Embedded web page» y cada aplicación tal como se muestra a sí misma; la imagen no lleva ninguna marca del recuadro, por lo que no demuestra que una página iframe se mostrara.

Para varios ids o --tag, la respuesta es un resultado de flota con action: "screenshot", el selector, y el directorio output; cada resultado ok lleva path, bytes, sha256, width y height. Con --tag, la CLI primero lista las pantallas etiquetadas, siguiendo cada página de lista; cada página de lista se factura y las capturas son gratuitas, y varios ids no necesitan lista. --idempotency-key se rechaza en esta forma, porque cada captura usa su propia clave. Si una captura falla inesperadamente, el resultado de esa pantalla es unexpected_error, no se inician nuevas capturas, las pantallas que esperan reportan not_attempted y el código de salida es 1.

Establecer, agregar, eliminar o borrar las etiquetas en una pantalla o una flota.

screen tag (<id>... | --tag TAG) (--set TAGS | --add TAGS | --remove TAGS | --clear) [--expect-rev REVISION]

screenrig screen tag scr_01EXAMPLESCREEN00000000 --set Lobby,Floor2
screenrig screen tag scr_01EXAMPLESCREEN00000000 --add Spring
screenrig screen tag --tag Lobby --add Spring

Una etiqueta tiene de 1 a 32 letras o dígitos, y una pantalla lleva como máximo 16 etiquetas únicas. Las etiquetas seleccionan flotas; nunca son autorización ni llegan al Player. Cambiar etiquetas aumenta la revisión de la pantalla, no la revisión del manifiesto. Para una pantalla, el sobre es la pantalla actualizada. --add y --remove leen primero la pantalla y escriben el nuevo conjunto protegido por --expect-rev o la revisión recién leída, por lo que un cambio concurrente devuelve revision_conflict (salida 6) en lugar de sobrescribirse; vuelva a ejecutar el comando. En una flota, --add y --remove se aplican atómicamente contra el conjunto almacenado de cada pantalla, y una pantalla que pasaría de 16 etiquetas falla en su propio resultado con invalid_request.

Dondequiera que cambien las etiquetas (screen tag, una actualización de pantalla mediante la API, el editor de etiquetas del panel), el levels de la respuesta lista, en gained y lost, las campañas a cuya audiencia de etiquetas la pantalla entró o de la que salió, cada una con su source (campaign), id, el recuento de screens y, cuando la campaña tiene alcance, reach_before y reach_after. Un screen tag de flota los suma sobre toda la flota. Lea levels.lost antes de considerar inofensiva una edición de etiquetas: quitar la última etiqueta coincidente de las pantallas de una campaña vacía ese grupo y activa las notificaciones reach_dropped y group_empty.

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

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) --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

Cada lista de reproducción que un horario nombra se valida como una asignación, y la pantalla necesita una zona horaria y una lista de reproducción predeterminada asignada. Cuando ninguna entrada rige, se reproduce la lista asignada. Si una lista programada no puede mostrarse, 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) [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule clear --tag Cafe

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 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. 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) --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 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. 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) [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover clear --tag Lobby

Listar las campañas del proyecto en el orden en que las pantallas las leen.

campaign list

Sin parámetros.

screenrig campaign list

data.items contiene como máximo 100 campañas, las de mayor prioridad primero y, dentro de una misma prioridad, las más nuevas primero. Una campaña pausada aparece en la lista y no se aplica en ninguna parte.

Lea una campaña.

campaign show <id>

screenrig campaign show cmp_LUNCH

Devuelve name, playlist_id, audience (la regla exacta), priority, paused, los from, until, windows, monthly, dates, except, interaction, displays y start que están establecidos, y revision, el valor para --expect-rev en una escritura posterior. reach informa cuántas pantallas coinciden con la audiencia: published cuando la campaña se publicó por última vez (creada, o actualizada con una nueva audiencia, lista de reproducción o estado de pausa), current y at para el recuento más reciente, y empty_groups, las hojas tag:NAME y folder:ID de la audiencia que no coinciden con ninguna pantalla. Una etiqueta, carpeta, archivo o eliminación que cambia el recuento se vuelve a contar en unos 15 segundos; campaign list también lleva reach, y las notificaciones reach_dropped y group_empty lo vigilan. Un id de ads campaigns list responde not_found (salida 4) aquí.

Cambiar las pantallas de una audiencia a una lista de reproducción, siempre o mientras rigen sus reglas.

campaign create --name NAME --playlist-id ID (--tag TAG | --any-tag TAG | --screen-id ID | --folder ID | --all-screens | --audience RULE) [--from TIME] [--until TIME] [--window SPEC] [--monthly SPEC] [--date SPEC] [--except DATES] [--on-touch [IDLE_S]] [--displays N[,N]] [--start on-time|next-item] [--covers WHERE] [--priority N] [--paused]

screenrig campaign create --name "Lunch menu" --playlist-id pl_LUNCH --tag north --window mon-fri@11:00-14:00
screenrig campaign create --name "North Tower welcome" --playlist-id pl_WELCOME --folder sfd_01EXAMPLEFOLDER000000000
screenrig campaign create --name "Holiday hours" --playlist-id pl_HOLIDAY --tag Lobby --from 2026-12-20T00:00 --until 2027-01-02T00:00 --priority 10
screenrig campaign create --name "North cafes" --playlist-id pl_CAFE --audience '{"all":[{"tag":"North"},{"any":[{"tag":"Cafe"},{"tag":"Patio"}]}]}' --paused
screenrig campaign create --name "Brunch" --playlist-id pl_BRUNCH --tag Cafe --monthly 1st-sun@10:00-14:00 --except 2026-12-06
screenrig campaign create --name "Touch to browse" --playlist-id pl_MENU --screen-id scr_KIOSK --on-touch 90
screenrig campaign create --name "Holiday opening" --playlist-id pl_HOLIDAY --tag Lobby --date 2026-12-24@18:00-22:00 --start on-time
screenrig campaign create --name "Wall outputs 1 and 2" --playlist-id pl_WALL --screen-id scr_WALL --displays 1,2

Las etiquetas tienen de 1 a 32 letras o dígitos. DAYS es daily, un día (mon), un rango (mon-fri; fri-mon cruza el final de la semana) o una lista separada por comas (sat,sun). Sin hora, la ventana es todo el día, y un fin igual o anterior al inicio cruza la medianoche y pertenece al día de inicio. En una regla --audience cada miembro tiene exactamente uno de all, any, tag, screen_id o folder, los grupos se anidan hasta 3 niveles de profundidad, una audiencia tiene como máximo 500 reglas y {"all":[]} equivale a todas las pantallas.

Después de una creación interrumpida o ambigua, vuelva a ejecutar el mismo comando dentro de 24 horas: reutiliza la clave de idempotencia guardada, y el servidor devuelve la misma campaña en lugar de crear otra.

Cambiar una campaña; las pantallas de su audiencia anterior y de la nueva se vuelven a resolver dentro de un minuto.

campaign update <id> [--name NAME] [--playlist-id ID] [audience option] [--from TIME | --clear-from] [--until TIME | --clear-until] [--window SPEC | --clear-windows] [--monthly SPEC | --clear-monthly] [--date SPEC | --clear-dates] [--except DATES | --clear-except] [--on-touch [IDLE_S] | --clear-on-touch] [--displays N[,N] | --clear-displays] [--start WHEN] [--covers WHERE] [--priority N] [--expect-rev REVISION]

screenrig campaign update cmp_LUNCH --playlist-id pl_LUNCH2 --expect-rev 2
screenrig campaign update cmp_LUNCH --tag Lobby --window sat,sun --priority 20
screenrig campaign update cmp_LUNCH --clear-until --clear-windows
screenrig campaign update cmp_BRUNCH --monthly 2nd-sun@10:00-14:00 --except 2026-12-13,2027-01-10
screenrig campaign update cmp_BROWSE --clear-on-touch --clear-displays

Pase al menos un cambio; solo cambian los campos que pase. Un --playlist-id nuevo se verifica como al crear. Después de una solicitud interrumpida o ambigua, vuelva a ejecutar el mismo comando: reutiliza la clave de idempotencia guardada, y el servidor devuelve la actualización que ya ocurrió en lugar de aplicarla de nuevo.

Detener una campaña en todas las pantallas sin eliminarla.

campaign pause <id> [--expect-rev REVISION]

screenrig campaign pause cmp_LUNCH

Las pantallas que la mostraban vuelven a lo que mostrarían sin ella dentro de un minuto. campaign resume la inicia de nuevo.

Iniciar de nuevo una campaña pausada.

campaign resume <id> [--expect-rev REVISION]

screenrig campaign resume cmp_LUNCH

Cada pantalla de la audiencia a la que la campaña puede aplicarse cambia a su lista de reproducción dentro de un minuto mientras la campaña rige.

Eliminar una campaña.

campaign delete <id> [--expect-rev REVISION]

screenrig campaign delete cmp_LUNCH

La campaña no regresa. Cada pantalla que la muestra vuelve a lo que mostraría sin ella dentro de un minuto; las listas de reproducción, las pantallas y las etiquetas permanecen. campaign pause detiene una campaña y la conserva.

Mostrar las pantallas que alcanza una campaña y el estado de cada una.

campaign screens <id> [--limit N] [--cursor CURSOR]