Manual del operador#

Guía completa de instalación y operación de la app de escritorio de YCtlX (versión 2.27). Pensada para entrenar a alguien que nunca la usó.

Este manual cubre solo la app de escritorio, el .exe que se instala en la PC. Todo lo que dice acá aplica a esa versión. Si estás usando YCtlX desde un navegador, hay diferencias importantes, sobre todo con las rutas de los archivos, y este documento no es el indicado.

1. Qué es YCtlX y qué no es#

YCtlX es el control de VTR para los inputs tipo List de vMix. Sirve para armar el orden de los clips de un bloque, mandarlo a vMix, y después manejarlo en vivo: cuear el clip que sigue, darle play, pausar, y ver cuánto le queda al que está saliendo al aire.

Lo que hace:

• Arma playlists de video, ordenadas a mano o por código de rundown.
• Se conecta a vMix por la red y trae sus Lists, o le manda las tuyas.
• Cuea, reproduce y pausa el clip cargado en cada List.
• Muestra la cuenta regresiva del clip al aire y el tally real de vMix.
• Exporta e importa .m3u.

Lo que NO hace, y conviene tener claro desde el primer día:

• No reproduce video. El video lo reproduce vMix. YCtlX es el control remoto: nada de lo que ves en pantalla es la señal.
• No muestra miniaturas ni una preview de imagen del clip. La API de vMix no las ofrece, así que no hay forma de mostrarlas.
• No mezcla audio. No hay mute ni faders acá, eso se hace en vMix.
• No pone nada al aire por sí solo. Poner un input en Program lo hace el switcher, no esta app.

Vocabulario#

Estos términos se usan durante todo el manual y son los que vas a escuchar en sala.

2. Requisitos#

En la PC donde vas a instalar YCtlX#

• Windows 10 o 11, con permiso para instalar programas. Desde la 2.24 también hay build de macOS, en Apple Silicon e Intel.
• Acceso de red a la máquina donde corre vMix.
• Espacio en disco: poco. El instalador de la 2.22 pesaba 78,5 MB porque llevaba un navegador entero adentro; el de la 2.24 usa el que ya trae el sistema y es una fracción de eso.
• En Windows, WebView2. Windows 11 lo trae de fábrica y en Windows 10 lo instala Edge, así que en la práctica ya está; si faltara, el instalador lo baja solo. Es lo único que la instalación puede querer de internet, y una sola vez.

En la máquina de vMix#

• El Web Controller de vMix tiene que estar activo. En vMix: Settings → Web Controller. El puerto por defecto es el 8088.
• El firewall de esa máquina tiene que dejar pasar ese puerto desde la red local.

Si el Web Controller está apagado, YCtlX no puede hacer absolutamente nada contra vMix, por más que la red esté bien.

Lo que NO hace falta#

• Internet. La app funciona entera sin salida a internet. Nada se baja de afuera mientras corre.
• Un servidor. El .exe no necesita ningún servicio corriendo en ningún lado, más que vMix.
• Un navegador. La app es una ventana propia.
• Usuario y contraseña. No hay login, en ningún lado.

Opcional: ffprobe#

Si la PC tiene ffprobe instalado y accesible desde el PATH, YCtlX lo usa como último recurso para leer la duración de los formatos que el motor de la app no sabe decodificar, típicamente ProRes y casi todo MXF. Si no está instalado no pasa nada malo: esos clips simplemente muestran --:-- en la columna de duración. No es un error ni hay que reportarlo.

3. Instalación#

Conseguir el instalador#

El instalador es un solo archivo, llamado:

YCtlX-Setup-X.XX.exe

donde X.XX es el número de versión. Pedíselo a quien te provee YCtlX.

Antes de instalar, mirá el número en el nombre del archivo y confirmá que sea la versión que esperabas. Una vez instalada, la versión también se puede ver dentro de la app, en ⚙ → About.

Instalar#

1. Ejecutá el archivo YCtlX-Setup-X.XX.exe.
2. Windows va a mostrar un aviso azul de SmartScreen que dice "Windows protegió su PC" y menciona un editor desconocido. Es esperable y no significa que el archivo tenga algo raro: Windows lo muestra en todo programa que no venga con una firma digital comprada a una autoridad certificadora. Hacé clic en Más información y después en Ejecutar de todas formas.

Si el navegador se negó a bajar el archivo antes incluso de llegar acá, buscá el aviso en la lista de descargas y elegí Conservar o Mantener de todas formas.

1. El asistente te deja elegir la carpeta de instalación. Si no tenés un motivo, dejá la que propone.
2. Crea un acceso directo en el escritorio automáticamente.
3. Al terminar, abrí YCtlX desde el escritorio o el menú Inicio.

Si Windows 11 bloquea la instalación y no te deja continuar#

Distinto del aviso anterior. Si en vez de un aviso que podés saltear te aparece un bloqueo sin ninguna opción para continuar, se trata de Smart App Control, una función que viene activada de fábrica en instalaciones nuevas de Windows 11 y que bloquea programas sin firma digital.

A diferencia de SmartScreen, acá no hay un "Ejecutar de todas formas". Para instalar hay que desactivarlo:

1. Abrí Seguridad de Windows.
2. Entrá en Control de aplicaciones y navegador.
3. En Smart App Control, elegí Desactivado.
4. Volvé a ejecutar el instalador.

Un aviso importante: en versiones de Windows anteriores a abril de 2026, desactivar Smart App Control era irreversible (había que reinstalar Windows para volver a activarlo). Con Windows actualizado se puede volver a activar cuando quieras. Si tenés dudas, consultá con el área de sistemas de tu canal antes de tocarlo.

La instalación es para el usuario actual de Windows por defecto. Si en esa PC operan varias personas con usuarios distintos de Windows, cada una va a tener su propia instalación y su propia configuración.

La app no pide ninguna clave ni activación: al terminar de instalar, se abre y ya está lista para usar. Tampoco necesita internet para funcionar, solo la red local para llegar a vMix.

Desde la 2.24 la app no inventa un deck al abrirse. Antes creaba uno llamado List 1 que casi todos renombraban o borraban. Ahora la pantalla vacía te ofrece Add a deck y, si ya guardaste la dirección de vMix, Import from vMix. Si todavía no la guardaste, ese segundo botón dice Set up vMix y te lleva a configurarla. El primer deck lo decidís vos.

Actualizar a una versión nueva#

No hay actualización automática. La app no avisa cuando sale una versión nueva ni se actualiza sola. Actualizar es bajar el .exe nuevo y ejecutarlo: se instala encima de la anterior.

Al actualizar se conservan la configuración de vMix y las playlists de esa PC. No hay que volver a cargar nada.

Desinstalar#

Se desinstala como cualquier programa de Windows, desde Configuración → Aplicaciones. Si además querés borrar la configuración y las playlists guardadas, hay que borrar a mano la carpeta %APPDATA%\YCtlX (ver el apéndice).

4. Configuración inicial, una vez por PC#

Toda esta configuración vive en esta computadora. No se comparte, no se sincroniza, no viaja. Si mañana instalás YCtlX en otra PC, hay que repetirla ahí.

Abrí la configuración con el botón ⚙ de la barra superior, o con Ctrl+B.

4.1 Pestaña Mode: MASTER o CLIENT#

Lo primero que hay que decidir en cada máquina. Define para qué sirve esa PC.

CLIENT es una medida de seguridad real, no una pantalla más limpia. En una máquina en CLIENT, nada de lo que hagas puede tocar lo que está al aire. Es el modo para la PC del productor, del redactor o de quien arma el rundown desde otra oficina.

Cambiar de modo no destruye nada: los decks, el orden de los clips y los vínculos con vMix quedan intactos y vuelven apenas volvés a MASTER.

El modo se ve siempre en la barra superior, al lado del botón de tema. Ese indicador no cambia el modo al hacerle clic, abre esta pestaña de configuración. Es a propósito: salir de MASTER por un clic accidental en pleno programa sería el peor accidente que ese botón podría causar.

4.2 Pestaña vMix connection#

Solo aparece en modo MASTER.

1. En vMix IP address escribí la IP de la máquina donde corre vMix, con el formato x.x.x.x. En este manual esa dirección aparece como IP_VMIX.
2. En Port dejá 8088, salvo que en vMix hayan cambiado el puerto del Web Controller.
3. Apretá Test connection. Si todo está bien vas a leer Connected. N input(s) found in vMix. con la cantidad de inputs que tiene vMix en ese momento.
4. Apretá Save. Recién ahí queda guardada.

Si Test connection falla, andá al capítulo 9, que tiene cada mensaje de error con su causa.

Ojo con esto y decilo en voz alta cuando entrenes a alguien: no hay contraseña, por diseño. Cualquiera en esa red que abra la app y ponga la IP puede manejar vMix. La app confía en que la red de producción es confiable.

4.3 Pestaña Files#

En la app de escritorio no hace falta tocarla. Existe para la versión de navegador, donde el navegador nunca revela dónde está un archivo en el disco y hay que decírselo a mano. El .exe lee la ruta real de cada archivo directamente, así que ignora esta configuración.

Lo que sí conviene leer de esa pestaña es la nota sobre las rutas, porque explica el error más común de todos. YCtlX no manda archivos: le manda a vMix la ruta de cada clip, como texto, y vMix la abre por su cuenta. Eso quiere decir que la ruta tiene que ser válida desde la máquina donde corre vMix, no desde la tuya.

Si YCtlX está en la misma PC que vMix, no hay nada que pensar. Si está en otra, hay una sola regla:

Todos los clips en una unidad de red, con la misma letra o la misma ruta UNC en las dos máquinas.

Un clip en D:\Media\show.mp4 de tu PC no existe para una vMix que no tiene esa D:. En cambio \\SERVIDOR\Media\show.mp4, o una unidad de red montada como M: en las dos, funciona igual desde cualquiera de las dos.

Cuando falla, vMix no avisa: acepta el comando y deja la entrada en negro. Por eso vale hacer la prueba con un clip antes del primer show, no durante.

4.4 Tema claro y oscuro#

El botón de sol y luna de la barra superior alterna entre los dos. Por defecto sigue lo que tenga configurado Windows; apenas elegís uno a mano, esa elección queda fija y ya no cambia sola.

Para sala oscura, el tema oscuro. El claro es más cómodo para armar rundowns en una oficina con luz.

5. Conocé la pantalla#

5.1 El layout completo#

+--------------------------------------------------------------------------+
|  > YCtlX  vMix VTR        * vMix IP_VMIX · CONNECTED         MASTER  ☼ ⚙ |  <- barra superior
+--------------------------------------------------------------------------+
|                                                                          |
|  +---------------------+  +---------------------+  +-------------------+ |
|  |                     |  |                     |  |                   | |
|  |       DECK 1        |  |       DECK 2        |  |      DECK 3       | |  <- el rack
|  |                     |  |                     |  |                   | |
|  +---------------------+  +---------------------+  +-------------------+ |
|                                                                          |
+--------------------------------------------------------------------------+
|  [10:32:07] VTR-A: CUE "5A1-Apertura"     SYSTEM ACTIVE  NETWORK: OK ... |  <- barra de estado
+--------------------------------------------------------------------------+

Barra superior, de izquierda a derecha:

• El nombre YCtlX con vMix VTR debajo. La versión aparece abajo a la izquierda, antes del >_, para leerla sin abrir nada.
• El estado de la conexión con vMix: Not connected antes de configurarla, y después vMix IP_VMIX · CONNECTED con la IP que configuraste y un punto verde, o · OFFLINE con un punto rojo si vMix dejó de responder.
• El indicador de modo, MASTER o CLIENT.
• El botón de tema y el botón de configuración ⚙.

El rack muestra los decks uno al lado del otro. Podés tener hasta 6 decks a la vista al mismo tiempo. Cuál se ve depende de los decks fijados (ver 6.9). Si la ventana es angosta, los decks se apilan uno debajo del otro.

Barra de estado, abajo:

• A la izquierda, el registro del último comando, con la hora: [10:32:07] VTR-A: CUE "5A1-Apertura". Es lo primero que hay que mirar cuando algo no responde como esperabas.
• A la derecha, SYSTEM ACTIVE o STANDBY, NETWORK: OK o DOWN, y LATENCY: con los milisegundos reales que tarda vMix en contestar. Una latencia que se dispara es un problema de red, no de la app.

5.2 Un deck por dentro#

+------------------------------------------------------+
| VTR-A                                ⋯   ⚠  [PROGRAM]|  <- nombre, menú, pendiente, bus
+------------------------------------------------------+
|                                                      |
|                     00:47                            |  <- cuenta regresiva
|                                                      |
|   [ ▶ ]  5A1-Apertura                                |  <- clip cargado
|          00:01:30                                    |
|                                                      |
|  00:00:43 |=========o--------------| 00:01:30        |  <- scrub
|              [⟲] [⏭] [C]                             |     Loop / Auto Next / Auto Cue
|                                                      |
|  [⇅]      [⏮] [◼] [▶] [⏸] [⏭]                   [⑂] |  <- Sort, transporte, Split
+------------------------------------------------------+
| ▤ 1  5A1-Apertura      01:30   D:\Media\...   ON AIR |
| ▤ 2  5A2-Nota          02:15   D:\Media\...          |  <- playlist
| ▤ 3  5A11-Cierre       00:45   D:\Media\...          |
+------------------------------------------------------+

De arriba hacia abajo:

1. El nombre del deck. Es una etiqueta, no se edita desde acá: se renombra en Settings → Decks (ver 5.2), y en un deck vinculado a vMix el cambio va también al input de allá.
2. El menú ⋯ con el resto de las acciones del deck. Ver 5.3.
3. El chip de cambios pendientes (un triángulo de alerta), que aparece solo cuando hay cambios guardados que todavía no llegaron a vMix. Ver el capítulo 8.
4. El badge de bus, arriba a la derecha: PROGRAM en rojo, PREVIEW en verde, READY cuando está vinculado y en ningún bus, y LOCAL cuando el deck no está vinculado a vMix. Todo el borde superior del deck se tiñe del mismo color.
5. La cuenta regresiva, el número grande. Es el tiempo que le queda al clip actual, no el transcurrido.
6. La pantalla, con el nombre del clip cargado y su duración total centrados, uno encima del otro. De fondo, en grande y desenfocado, el icono del tipo de medio: una película para video, una cámara para foto y una nota para audio; se decide por la extensión del archivo, y lo que no se reconoce se muestra como video. Ese fondo toma el color del bus, rojo en PROGRAM y verde en PREVIEW, así que la pantalla también dice al aire desde el rabillo del ojo. Sin clip cargado no hay fondo: la pantalla queda vacía y dice No clip loaded.
7. El botón Create in vMix, sobre el borde derecho de esa misma pantalla, y solo en un deck que todavía no existe en vMix. Ver 7.1.
8. El scrub, la barra de posición. Se puede arrastrar para mover el playhead. A los costados, la posición actual y la duración total.
9. Los tres toggles en el medio del scrub: Loop, Auto Next y Auto Cue. Ver 7.5.
10. La fila de transporte: el botón Sort a la izquierda, los cinco botones de transporte en el centro, y el botón de split (el icono que se bifurca) sobre el borde derecho. Ver 7.4 y 6.8. Los dos de los extremos son locales: reordenan o reparten clips de este lado, así que siguen disponibles en modo CLIENT y con el deck al aire.
11. La playlist, con una fila por clip.

5.3 El menú ⋯ del deck#

Pull from vMix y Push to vMix solo aparecen si el deck está vinculado y estás en MASTER.

El menú se cierra solo: al elegir una opción, al apretar Esc, o con un clic en cualquier otro lado de la pantalla. Solo puede haber uno abierto a la vez, así que abrir el de otro deck cierra el anterior. La única opción que no lo cierra es Path under each clip, que es un interruptor y se suele prender y apagar un par de veces seguidas.

5.4 Una fila de la playlist#

Cada fila lleva dos líneas que arrancan en el mismo punto: arriba el icono del tipo de medio con el nombre del clip al lado, y abajo la duración y la ruta del archivo. Sobre el borde derecho, el número de posición y la palabra de estado: ON AIR, PREVIEWING o READY.

El icono es el mismo que el fondo de la pantalla del deck y sale de la extensión del archivo: película para video, cámara para foto y nota musical para audio. Está ahí porque una List de vMix no lleva solo videos: los gráficos y las camas musicales van en la misma playlist, y no es lo mismo cuear una placa que un informe de dos minutos.

Al pasar el mouse aparecen las acciones de la fila:

• C: elige ese clip. Es el único botón que se ve siempre, sin pasar el mouse, porque es el que más se usa. El C en ámbar marca el clip que sale a continuación, no el que está cargado: mientras un clip rueda, cuál es lo dice el tally rojo de la fila, y lo que hace falta saber es qué viene detrás. Con el deck parado los dos son el mismo clip.

Qué hace el botón depende de cómo esté el deck:

• Deck parado: carga ese clip en vMix ahí mismo, como siempre.
• Deck reproduciendo, o al aire: no toca vMix. Anota que ese es el que sigue, lo marca en ámbar, y lo carga solo cuando la toma termina o el deck sale del aire. Por eso se puede apretar en vivo sin riesgo: durante la toma no sale ni una llamada hacia vMix.

Con Auto Cue o Auto Next encendidos y nadie eligiendo a mano, el ámbar marca el clip al que van a ir. Elegir uno a mano gana siempre.

• El botón de mover (las cuatro flechas): manda ese clip a otro deck.
• El tacho: borra el clip. No pide confirmación, tenelo presente.

El nombre del clip no se puede editar. Identifica un archivo real en el disco, así que cambiarlo solo lograría que la app y la realidad digan cosas distintas. La ruta sí se puede editar, salvo en los clips que vinieron de vMix.

A la izquierda de cada fila hay una manija para arrastrar, con la que se reordena la playlist o se mueve un clip a otro deck.

5.5 Los colores, todos juntos#

Esta es la tabla que conviene tener memorizada antes de sentarse a operar.

El turquesa se eligió justamente para eso: el rojo, el verde y el ámbar están reservados para el estado del aire, y ningún otro elemento puede competir con ese significado. Ojo con no confundir el turquesa de un botón con el verde de Preview: el verde del tally es más intenso y siempre aparece en el badge o en el borde del deck, nunca en un botón suelto.

6. Armar una playlist#

6.1 Crear un deck#

Settings → Decks → New deck. El deck nuevo aparece en el rack.

Una instalación nueva no trae ningún deck. Abre sobre una pantalla vacía, con el logo de fondo, y ofrece las dos únicas cosas que se pueden hacer desde ahí: Add a deck, o Import from vMix si ya guardaste la dirección. Si todavía no la guardaste, ese segundo botón dice Set up vMix y te lleva a la pestaña de conexión. Antes la app inventaba un deck llamado List 1 que casi todos terminaban renombrando o borrando; ahora el primero lo decidís vos.

El tope son seis decks, y cuentan por igual los que hacés a mano y los que traés de vMix. Al lado del botón vas viendo cuánto lugar queda (2 of 6 still free), y al llegar a seis el botón se apaga.

Renombrar: en la lista de Settings → Decks, el botón del lápiz de la fila abre el nombre para editarlo ahí mismo. Enter lo guarda y Escape lo deja como estaba. Es el único lugar donde se renombra: el título de arriba del deck es una etiqueta.

Si el deck está vinculado a vMix, el nombre se cambia también en vMix, en el input que le corresponde, y el que queda es el que vMix informa de vuelta. Los dos lados dicen siempre lo mismo, que es lo que importa cuando alguien canta un VTR por intercom. Si vMix no contesta, el nombre igual queda de este lado y un aviso te dice que allá no llegó.

Borrar: el mismo menú tiene Delete, con confirmación. Borra el deck de YCtlX y nada más: la List en vMix queda intacta.

6.2 Arrastrar archivos#

Arrastrá uno o varios archivos desde el explorador de Windows y soltalos en cualquier parte del deck. El deck entero es zona de drop, no hace falta apuntar a un lugar específico.

Qué acepta. Una List de vMix no es solo video, así que el filtro tampoco lo es:

Son los que vMix abre en una List. Lo que no esté en la lista se ignora en silencio, para que soltar una carpeta con .txt y .xml adentro no te llene el deck de basura.

En la app de escritorio las rutas salen completas solas. El aviso toma la forma N video(s) added with their full path. Si alguna vez ves un badge ámbar que dice Needs folder, es porque ese clip llegó por otro camino, no por arrastre.

6.3 Arrastrar una carpeta entera#

Se puede soltar una carpeta completa. YCtlX entra en ella, incluidas las subcarpetas, y agrega todo el material que encuentre, conservando la estructura en las rutas. Lo que no es medio reconocido se ignora.

Funciona bien con carpetas grandes, de más de cien clips.

6.4 Escribir o pegar rutas#

⋯ → Add clips by path abre un campo de texto. Podés:

• Escribir una ruta completa y apretar Enter.
• Pegar varias líneas de una sola vez: se agrega un clip por línea. Es la forma más rápida de cargar un rundown que te pasaron por chat o por mail.

6.5 Importar un .m3u#

⋯ → Import .m3u, o directamente soltá el archivo .m3u sobre el deck. Acepta el formato extendido y el plano, incluso mezclados en el mismo archivo.

6.6 Traer una List desde vMix#

Ver 7.1. Es lo habitual cuando el bloque ya está armado del lado de vMix.

6.7 Ordenar por código de rundown#

El botón Sort de la fila de transporte ordena el deck leyendo el código del nombre del archivo, con el formato 5A1-NOMBRE:

Ordena primero por show, después por segmento, después por nota, y los números como números. Esa es la gracia: el orden alfabético pone 5A11 antes que 5A2, y este no.

antes:    5A11-Cierre, 530A1-Nota, 11B2-Nota, 5A2-Nota, 6A1-Nota, 5A1-Apertura, bumper.mp4
después:  5A1-Apertura, 5A2-Nota, 5A11-Cierre, 6A1-Nota, 11B2-Nota, 530A1-Nota, bumper.mp4

El patrón se reconoce de forma estricta: dígitos, una letra mayúscula, dígitos, y un guion. Un nombre que no encaje exacto (5a1- en minúscula, 5 A1 - con espacios, 5A1nota sin guion) se considera sin código y va al final, ordenado por nombre. El aviso te dice cuántos quedaron ahí, así que si el número te sorprende, revisá cómo están nombrados los archivos.

Sort ordena solo el deck donde apretaste el botón, y una sola vez. Después podés arrastrar libremente y nada se reacomoda solo.

6.8 Repartir un deck entre dos, A/B roll#

El botón de split, al lado del nombre del deck, reparte los clips uno sí y uno no con otro deck: el 1°, el 3° y el 5° se quedan; el 2°, el 4° y el 6° se van al destino.

Sirve para lo de siempre en sala: mientras VTR-A reproduce un clip, el que sigue ya está cargado y cueado en VTR-B, así que el pase es instantáneo.

Al apretarlo se abre un menú para elegir el deck destino, o para crear el compañero en el momento. Si el deck se llama VTR-A, propone crear VTR-B. Lo que el destino ya tenía se conserva, y lo repartido se agrega al final.

Necesita al menos 2 clips para tener sentido, y si no los hay te avisa.

6.9 Elegir qué decks se ven#

En Settings → Decks está la lista de todos tus decks. Cada uno tiene un botón de fijar y uno de borrar.

• Sin nada fijado, se ven todos los decks (hasta 6, que es lo que entra en el rack).
• Con decks fijados, se ven esos, hasta los 6 que entran en el rack.
• El deck en el que estás trabajando siempre se muestra, esté fijado o no.

Hacer clic en el nombre de un deck lo trae al frente. Ni eso, ni fijar, ni borrar cierran la ventana, así podés acomodar varios de una.

Tope de seis. La app admite seis decks como máximo, contando por igual los que creás a mano y los que traés de vMix. Junto al botón de crear vas viendo cuánto lugar queda (2 of 6 still free), y al llegar a seis el botón se apaga. Si querés importar Lists de vMix y no entran, la app te pregunta cuáles decks reemplazar en vez de mandarte a borrar y volver.

Borrar varios decks de una vez#

Cada fila de la lista tiene además una casilla a la izquierda. Al tildar la primera aparece una barra arriba de la lista que dice cuántos decks y cuántos clips tenés seleccionados, con dos botones: Clear selection y Delete selected.

El aviso de confirmación nombra los decks que se van a borrar, no solo cuántos son. Leelo: esto no se puede deshacer. Si tildaste todos, además te avisa que va a dejar un deck vacío en su lugar, porque el rack nunca se queda sin ninguno.

Tildar una casilla no cambia de deck ni cierra la ventana, así que podés ir marcando varios tranquilo. La selección se descarta sola al cerrar la configuración: nunca vas a volver a abrirla y encontrar decks ya marcados para borrar.

Cambiar el orden de los decks en el rack#

El orden de los decks está bloqueado mientras no lo desbloquees. En un rack de seis decks, un clic que se resbala durante un programa es un deck que se movió de lugar, así que arrastrarlos no es algo que pase por accidente.

Para reordenarlos:

1. ⚙ → Decks y prendé el interruptor Unlock deck order.
2. Arrastrá los decks: por el nombre en esa misma lista, o por su encabezado en el rack. Las dos formas hacen lo mismo y se pueden mezclar.
3. Volvé a bloquearlos cuando termines.

Mientras esté desbloqueado, cada deck se dibuja con el borde punteado y en la barra de estado aparece el aviso DECK ORDER UNLOCKED. Ese aviso también es el botón para volver a bloquear, así no hay que abrir la configuración de nuevo.

Dos cosas para tener presentes:

• Se bloquea solo al cerrar la app. Nunca vas a abrir YCtlX con el rack desbloqueado.
• Con decks fijados, arrastrar en el rack reordena solo los que se ven. Los que están fuera de pantalla se quedan donde estaban.

Reordenar decks no toca nada en vMix: cambia en qué orden los ves vos, no los inputs de la otra máquina.

6.10 Reordenar, mover y borrar#

• Reordenar: arrastrá la fila por la manija de la izquierda. También se puede soltar en el espacio en blanco debajo del último clip.
• Mover a otro deck: arrastrá la fila hasta el otro deck, o usá el botón de mover de la fila y elegí el destino de la lista.
• Borrar un clip: el tacho de la fila. Sin confirmación.
• Vaciar el deck entero: ⋯ → Clear deck. Este sí pide confirmación, y si el deck está vinculado te avisa que también se vacía la List en vMix.

6.11 Exportar un .m3u#

⋯ → Export .m3u abre un diálogo con:

• El nombre del archivo, precargado con el nombre del deck. Los caracteres que Windows no admite se reemplazan solos y la extensión .m3u se agrega sola. Abajo ves exactamente cómo va a quedar.
• El switch Use absolute paths, encendido por defecto. Encendido, el archivo lleva la ruta completa de cada clip, que es lo que necesita vMix. Apagado, lleva solo los nombres.

Si algún clip no tiene la ruta resuelta y el switch está encendido, la exportación se frena y te ofrece definir la carpeta primero. Es a propósito: mejor frenar que generar un .m3u con rutas rotas que van a fallar en el peor momento.

6.12 Llevar la configuración a otra PC#

Settings → Files → Export configuration guarda un solo archivo .json con todo lo que hace falta para dejar otra máquina igual a esta:

• Los decks, con sus clips y sus rutas.
• La vinculación de cada deck con su List de vMix.
• La dirección y el puerto de vMix.
• El modo MASTER o CLIENT, el tema, la carpeta base y los toggles.

Import configuration en la otra PC lo lee y reemplaza lo que hubiera, con confirmación previa. Es la forma de montar una segunda estación de operación, o de recuperar una PC después de reinstalarla, sin volver a cargar nada a mano.

La dirección de vMix se incluye desde la 2.24. Antes quedaba afuera, porque vive del lado del host y no del estado guardado, y se llegaba a la máquina nueva con todos los decks y sin nada que respondiera.

7. Vincular con vMix y operar#

7.1 Traer las Lists de vMix#

1. ⚙ → vMix connection, con la conexión ya probada y guardada.
2. Apretá Detect. Aparece la lista de todos los inputs de tipo List que tiene vMix en ese momento, con la cantidad de clips de cada uno.
3. Tildá los que quieras con las casillas, o usá Select all.
4. Apretá Import selected. Cada List entra como un deck nuevo, vinculado, con sus clips actuales.

Si una List ya está en un deck, se saltea en vez de duplicarse, y te avisa cuántas salteó. Dos decks apuntando al mismo List input se pelearían en cada push, por eso no se permite.

Si aparece No List-type inputs were found in vMix., la conexión está bien pero vMix no tiene ningún input de tipo List. Podés crearlo desde acá mismo, como sigue.

Crear la List en vMix desde la app#

El camino inverso: un deck que armaste acá y que en vMix todavía no existe. En vez de recrearlo a mano del otro lado, en la pantalla de ese deck aparece el botón Create in vMix.

Un solo clic hace las tres cosas:

1. Crea en vMix un input de tipo List con el nombre del deck.
2. Vincula el deck a ese input, igual que si lo hubieras importado.
3. Manda los clips que el deck ya tenía.

A partir de ahí el deck es uno vinculado como cualquier otro: badge de bus, transporte, cuenta regresiva y tally.

El botón aparece solo en decks que no están vinculados, y solo en modo MASTER: en CLIENT nada de esta pantalla puede tocar vMix.

Si algo falla, el aviso distingue los dos momentos. Si no se pudo crear la List, el deck queda como estaba y se puede reintentar. Si la List se creó pero los clips no llegaron, el deck ya queda vinculado y alcanza con ⋯ → Push to vMix: no hay que volver a crear nada.

7.2 Pull y Push#

• Pull from vMix reemplaza el contenido del deck con lo que hay ahora en vMix. Se usa cuando alguien tocó la List directamente en vMix y querés partir de eso.
• Push to vMix manda el orden del deck a vMix.

En la operación normal casi nunca necesitás apretar Push a mano. Reordenar, ordenar con Sort y repartir con split mandan el cambio solos. El botón está para casos puntuales y para forzar un envío diferido, que es el tema del capítulo 8.

7.3 El badge de bus#

7.4 El transporte#

Los cinco botones del centro de la fila de transporte, de izquierda a derecha:

Play y Pause se iluminan según lo que esté haciendo vMix de verdad, no según lo último que apretaste.

Para cuear un clip puntual, no el actual, usá el botón C de esa fila de la playlist. Es la forma normal de armar el que sigue.

Dos botones se llaman C y hacen cosas distintas. El C de una fila cuea ese clip, ahora. El C de la barra de scrub, al lado de Loop y Auto Next, es el toggle de Auto Cue, que es una preferencia y no cuea nada en el momento.

El scrub se arrastra para mover el playhead del clip actual. Al soltarlo, vMix salta a esa posición.

No hay botón de mute. El audio se mezcla en vMix.

7.5 Los tres toggles#

Cuando están encendidos se pintan con su propio color, cada uno distinto para que se lea de lejos cuál de los tres está armado sin tener que acordarse de qué botón es cuál: Loop en azul, Auto Next en verde azulado y Auto Cue en ámbar, el mismo del C de las filas.

Loop lo maneja vMix y se lee de vMix en cada consulta, así que si alguien lo cambia allá, acá se ve. Auto Next no aparece en lo que vMix informa, así que ese lo recuerda YCtlX.

Auto Cue se dispara en dos momentos:

1. Cuando el deck sale del aire, sin importar si el clip terminó o si lo cortaron por la mitad. La toma terminó, así que el próximo queda armado. Este es el caso normal de operación.
2. Cuando un clip termina en un deck que no está al aire, por ejemplo un deck de ensayo.

Mientras el deck está en programa no hace nada: nunca carga algo por debajo de lo que está saliendo.

Si Auto Next de vMix está encendido, Auto Cue se hace a un lado y lo dice en el registro de la barra de estado: Auto Cue skipped, Auto Next is on. Los dos hacen lo mismo desde lugares distintos y se pisarían.

En el último clip de la lista ya no hay siguiente que cuear, así que desde la 2.24 re-cuea ese mismo clip cuando el deck sale del aire, aunque lo hayan cortado por la mitad. Queda de nuevo en 0:00, listo para repetirlo, en vez de dejar el playhead donde lo cortaron. No vuelve al primero de la lista: eso sería adivinar.

7.6 El reloj#

Es la cuenta regresiva del clip actual, no el tiempo transcurrido. Los números se ponen ámbar a los 15 segundos o menos y rojos a menos de 10 segundos.

vMix solo informa el tiempo del clip que tiene seleccionado, así que el reloj siempre habla de ese, no del total del bloque.

El reloj mantiene sus colores de aviso incluso con el deck en Program, que es justo cuando más importan.

8. Reglas de operación al aire#

Este es el capítulo que hay que leer dos veces.

8.1 Qué se bloquea con el deck en Program#

Apenas un deck entra en Program, la app desactiva sola:

• Los cinco botones de transporte: Prev, Cue, Play, Pause, Next.
• La barra de scrub.

Encima del transporte aparece el cartel ON AIR: LOCKED. Se desbloquea solo apenas el deck sale de Program.

El motivo: si está en Program, está al aire. Tocar cualquiera de esos controles cambia en el acto lo que ve el público.

Los botones C de las filas siguen andando, y desde la 2.26 a propósito: mientras el deck está al aire no mandan nada a vMix, solo anotan cuál querés que siga. Ver 5.4.

8.2 Qué sigue habilitado a propósito#

• Loop, Auto Next y Auto Cue. Solo afectan lo que pasa después de que termine el clip actual, así que se pueden armar en vivo sin riesgo.
• Sort y todo el reordenamiento de la playlist. El cambio se guarda, pero el envío a vMix se retiene, ver 8.3.
• Agregar clips, importar, exportar y mover clips entre decks.

Lo que se bloquea es lo que cambia ya mismo la salida. Editar la playlist no lo hace.

8.3 Reordenar al aire: el cambio se retiene#

vMix no tiene forma de reordenar una List en el lugar. Aplicar un orden nuevo obliga a vaciarla y volver a llenarla, y ese instante en que la List queda vacía manda negro a la salida. No es un parpadeo teórico: se ve al aire.

Por eso, cuando reordenás un deck que está en Program o reproduciendo:

1. El cambio se guarda localmente y NO se manda a vMix.
2. Aparece el chip ámbar en el título del deck, y el aviso te dice que el cambio quedó retenido.
3. Apenas el deck sale del aire y deja de reproducir, se manda solo. No hay que acordarse de nada.

En la barra de estado vas a ver VTR-A: off air, applying held changes cuando eso ocurre.

Agregar clips al final es la excepción y es seguro siempre, incluso al aire: no toca nada de lo que ya está, así que se sincroniza en el momento.

Un deck parado en una foto no cuenta como "reproduciendo". vMix reporta una imagen fija como si estuviera reproduciéndose, y nunca deja de hacerlo, porque no hay nada que terminar. Si eso contara, un deck de gráficos quedaría retenido para siempre y sus cambios no saldrían nunca. Lo que sí lo protege es el bus: si esa foto está en Program, el cambio se retiene igual que con un video.

8.4 Forzar el envío al aire#

El botón Push to vMix te deja forzarlo, pero antes te pregunta y te dice exactamente qué va a pasar:

"VTR-A" is live in vMix. vMix can't reorder a List in place, so applying this order empties and refills it, so the output goes black for an instant and playback stops. Do it anyway?

Regla operativa: durante un show, nunca. No hay forma de hacerlo invisible, es una limitación de la API de vMix y no se puede resolver del lado de YCtlX. Si el orden está mal y el bloque ya arrancó, lo correcto es usar Next y Prev para navegar, o cuear a mano el clip que corresponde, y dejar que el reorden se aplique solo cuando el deck salga del aire.

8.5 Checklist antes del show#

• La app está en modo MASTER en esta PC.
• La barra superior muestra CONNECTED en verde.
• NETWORK: OK y la latencia es baja y estable.
• Los decks del bloque están cargados y en el orden del rundown.
• Ningún clip muestra --:-- en la duración sin que sepas por qué.
• Ningún deck tiene el chip ámbar de cambios pendientes.
• El primer clip de cada deck está cueado, el reloj muestra la duración completa.
• Los decks que vas a usar están fijados y visibles en el rack.
• Si trabajás en A/B roll, los dos decks están repartidos y los dos cueados.

8.6 Durante el show#

• Mirá el reloj, no la playlist. El ámbar a 15 segundos es tu aviso de armar el pase.
• Antes de cuear, confirmá que el deck no esté en rojo.
• Después de cada toma, verificá que el clip siguiente quedó cueado. Con Auto Cue encendido se hace solo, pero conviene mirarlo.
• Si aparece el chip ámbar, no lo fuerces. Se va solo cuando el deck salga del aire.
• Si algo no responde, mirá primero el registro de la barra de estado.

8.7 Al terminar#

• Ningún deck quedó con el chip ámbar de cambios pendientes.
• Si el rundown de mañana cambia, exportá el .m3u antes de vaciar nada.
• Clear deck en los decks del bloque que ya salió, si corresponde. Acordate de que también vacía la List en vMix.

9. Cuando algo falla#

9.1 Errores de conexión#

9.2 Errores de la app de escritorio#

9.3 Problemas de operación#

9.4 Cuando hay que escalarlo#

Si nada de lo anterior explica el problema, hay dos cosas que le sirven al técnico y conviene juntarlas antes de llamar:

1. El registro de la barra de estado, la línea con la hora. Anotá exactamente lo que dice.
2. La línea de estado de abajo: dice el último comando enviado, si hay conexión y la latencia medida. Sacale una foto junto con el mensaje de error.

10. Entrenamiento: prácticas guiadas#

Para el instructor. Los seis ejercicios van de menor a mayor riesgo. Los primeros cinco se hacen con una vMix de prueba o con la de aire pero sin nada en Program. El sexto necesita coordinar con el switcher.

Práctica 1: instalar y conectar#

Objetivo: que el operador deje una PC lista solo.

1. Conseguir el instalador e instalarlo, incluido el paso de SmartScreen.
2. Abrir la app y entrar en ⚙.
3. Poner la máquina en modo MASTER.
4. Cargar la IP y el puerto de vMix, apretar Test connection y después Save.
5. Elegir el tema.

Sale bien si: la barra superior muestra CONNECTED en verde y la barra de estado dice NETWORK: OK.

Práctica 2: armar un deck y exportarlo#

Objetivo: manejar clips sin tocar vMix.

1. Crear un deck desde Settings → Decks → New deck y ponerle nombre.
2. Arrastrar una carpeta entera de clips.
3. Reordenar tres clips arrastrando.
4. Borrar uno.
5. Exportar el .m3u con Use absolute paths encendido.
6. Crear otro deck e importar ese mismo .m3u.

Sale bien si: el segundo deck tiene exactamente el mismo contenido y el mismo orden que el primero.

Práctica 3: vincular, cuear y reproducir#

Objetivo: el ciclo básico de operación.

1. ⚙ → vMix connection → Detect, tildar una List y Import selected.
2. Identificar el badge de bus del deck nuevo.
3. Cuear el tercer clip con su botón C y verificar en vMix que se cargó ese.
4. Play, mirar la cuenta regresiva bajar, y Pause.
5. Cue para volver a 0:00.
6. Arrastrar el scrub hasta la mitad del clip.
7. Probar Prev y Next.

Sale bien si: el operador puede decir, mirando la pantalla, qué clip está cargado y cuánto le queda, sin mirar vMix.

Práctica 4: ordenar por código de rundown#

Objetivo: entender el patrón y sus límites.

1. Armar un deck con clips nombrados 5A1-, 5A2-, 5A11-, 6A1-, y dos sin código.
2. Desordenarlos a mano.
3. Apretar Sort.
4. Leer el aviso: cuántos quedaron sin código.
5. Renombrar uno de los sin código a 5a3- en minúscula, volver a importarlo y ordenar de nuevo.

Sale bien si: el operador puede explicar por qué 5a3- quedó al final y qué hay que cambiarle al nombre.

Práctica 5: A/B roll con split#

Objetivo: el flujo de dos VTR.

1. Armar un deck con seis clips.
2. Apretar el botón de split y elegir crear el deck compañero.
3. Verificar el reparto: 1°, 3° y 5° de un lado; 2°, 4° y 6° del otro.
4. Fijar los dos decks para tenerlos lado a lado.
5. Cuear el primero de cada uno.
6. Reproducir el de A y, mientras corre, confirmar que B ya está armado.
7. Ensayar el pase: al llegar el reloj a ámbar, dar Play en B.

Sale bien si: el operador hace tres pases seguidos sin mirar la playlist, solo el reloj.

Práctica 6: comportamiento al aire#

Objetivo: que el operador vea el bloqueo y el envío diferido en un lugar seguro. Coordinar con el switcher.

1. Poner el deck en Program desde el switcher.
2. Ver el badge en rojo, el borde rojo y el cartel ON AIR: LOCKED.
3. Intentar apretar Play y un C de una fila. Leer el mensaje que aparece.
4. Reordenar dos clips de la playlist. Ver aparecer el chip ámbar.
5. Sacar el deck de Program.
6. Ver el chip desaparecer solo y leer off air, applying held changes en la barra de estado.
7. Confirmar en vMix que el orden nuevo llegó.

Sale bien si: el operador puede explicar con sus palabras por qué el reorden no se manda en el momento y por qué forzarlo mandaría negro al aire.

Checklist de competencias#

Para firmar cuando el operador puede hacer cada cosa sin ayuda.

• Instala y configura una PC desde cero.
• Distingue MASTER de CLIENT y sabe cuál corresponde a cada puesto.
• Arma un deck desde archivos, desde una carpeta y desde un .m3u.
• Importa una List de vMix y reconoce si un deck está vinculado.
• Lee el badge de bus y los colores del tally sin dudar.
• Cuea, reproduce, pausa y navega la lista con el transporte.
• Usa Sort y explica qué nombres quedan afuera del patrón.
• Arma un A/B roll con split y ejecuta los pases mirando el reloj.
• Explica qué se bloquea al aire y por qué.
• Explica el chip ámbar y por qué no hay que forzar el push en vivo.
• Diagnostica una falla de conexión y sabe cuándo escalarla.

11. Referencia rápida#

Para imprimir y dejar al lado de la consola.

Atajos#

Transporte#

Toggles#

Colores#

Iconos de la playlist#

El flujo mínimo de un show#

1. Verificar CONNECTED en verde arriba.
2. ⚙ → vMix connection → Detect e importar las Lists del bloque.
3. Ordenar con Sort o a mano. Fijar los decks que vas a usar.
4. Cuear el primer clip de cada deck con su botón C.
5. Al aire: mirar el reloj, dar Play, y armar el siguiente cuando llegue el ámbar.
6. Al salir del aire: confirmar que no quedó ningún chip ámbar.

Las tres reglas#

1. Rojo es al aire. Si el deck está en rojo, no se toca el transporte. La app lo bloquea, pero la regla es tuya.
2. El chip ámbar se va solo. Nunca forzar un push durante el show: manda negro a la salida.
3. Agregar al final siempre es seguro. Reordenar, no.

12. Apéndice#

12.1 Dónde vive cada cosa#

Nada de esto se sincroniza entre máquinas. Cada PC es independiente.

12.2 El formato .m3u que exporta#

Texto plano, una entrada por clip, con codificación UTF-8:

#EXTM3U
#EXTINF:-1,5A1-Apertura
D:\Media\Show\5A1-Apertura.mp4
#EXTINF:-1,5A2-Nota
D:\Media\Show\5A2-Nota.mp4

Es el formato que consume el input List de vMix, así que un .m3u exportado de acá se puede cargar directamente en vMix sin YCtlX de por medio.

12.3 Glosario de la interfaz#

La app está en inglés. Esta es la traducción de lo que vas a ver en pantalla.

| Use absolute paths | Usar rutas completas | | Needs folder / Set folder | Falta la carpeta, definir carpeta | | ON AIR / PREVIEWING / READY | Al aire, en preview, listo | | ON AIR: LOCKED | Al aire, controles bloqueados | | Not connected / CONNECTED / OFFLINE | Sin conectar, conectado, sin respuesta | | System ready | Sistema listo |

13. Aviso legal#

© 2026 HMY CORE LLC. Todos los derechos reservados.

YCtlX, incluyendo su código fuente, su interfaz, su nombre, su diseño gráfico y este manual, es propiedad exclusiva de HMY CORE LLC y está protegido por la ley de derechos de autor y por tratados internacionales.

Este es un software propietario. Se licencia para su uso, no se vende. Queda estrictamente prohibido copiarlo, distribuirlo, publicarlo, sublicenciarlo, alquilarlo, venderlo o crear obras derivadas de él, en todo o en parte, sin autorización previa y por escrito del propietario. Toda distribución comercial o venta no autorizada queda expresamente prohibida.

Queda prohibida la ingeniería inversa, la descompilación y el desensamblado de la aplicación, salvo en la medida en que la ley aplicable lo permita expresamente.

El software se entrega "tal cual", sin garantía de ningún tipo. El propietario no se hace responsable por daños derivados de su uso.

vMix es una marca de su respectivo dueño. YCtlX es un producto independiente y no está afiliado, avalado ni patrocinado por vMix.

Para licencias, permisos o consultas comerciales, contactar al propietario.

YCtlX 2.27. Este manual cubre la app de escritorio. La documentación técnica del proyecto está en el README.md del repositorio.