---
title: "Bridge QLab → grandMA2"
url: https://hernandez.systems/es/qlab-grandma2-bridge
lang: es
type: caso
alternate_en: https://hernandez.systems/en/qlab-grandma2-bridge
site: hernandez.systems
network: Osky Networks
---

# Bridge QLab → grandMA2

> Un puente que traduce los mensajes OSC de QLab 5 a comandos de una consola grandMA2 onPC por Telnet, para disparar la iluminación por red sin MIDI.

## El problema

En un show, el audio y el video suelen correr en **QLab** (Mac) y la iluminación en una consola **grandMA2 onPC** (Windows). Para que cada momento del show dispare la luz correcta, normalmente hay que montar MIDI físico, un puerto MIDI virtual o RTP-MIDI entre las dos máquinas.

## La solución

El bridge elimina esa capa. QLab manda por Ethernet triggers OSC abstractos, como `/lx/go/8`. El bridge los traduce al comando de grandMA2 que indique su archivo de configuración y se lo manda a la consola por **Telnet**, una interfaz nativa de grandMA2.

```
QLab ──OSC/UDP──► bridge ──Telnet/TCP──► grandMA2 onPC ──► Command Wing ──DMX──► luminarias
```

Cada trigger puede ejecutar cualquier comando de la línea de comandos de MA: un executor, un cue específico o una macro. El iluminador programa la consola; el operador de QLab solo coloca un Network Cue en cada escena.

## Cómo funciona

- **Instalación de una línea** en PowerShell, o desde un USB sin internet con el paquete descargado. Trae su propio Python portátil, verifica el SHA256 del paquete, abre el puerto OSC en el firewall, crea el arranque automático con Windows y al final muestra la IP que hay que poner en QLab.
- **Actualizar es volver a instalar:** la configuración se conserva.
- **Prueba de enlace:** un cue `/lx/ping` en QLab recibe `/lx/pong` con el estado de la conexión a la consola.
- **Modos de prueba** para revisar la configuración sin disparar nada o disparar un solo trigger.

## Robustez

- La conexión Telnet es persistente y con keepalive, así que el GO no espera a que se abra la conexión.
- Si la consola se reinicia, el bridge se reconecta solo cada 2 segundos; si un envío falla, reconecta y lo reintenta una vez.
- Si el bridge se cae, se reinicia solo, y no permite dos instancias abiertas que se repartan los mensajes.
- Los comandos directos a la consola están desactivados por defecto.
- Las pruebas automatizadas corren contra una grandMA2 simulada, sin necesidad de consola.

## Detalles técnicos

Python 3.8 o superior, sin paquetes extra. Instalador para Windows 8.1 o superior.

## Estado

Código público en GitHub: [MoscoDJ/qlab-grandma2-bridge](https://github.com/MoscoDJ/qlab-grandma2-bridge).

## Servicios relacionados

- [Eventos en vivo y experiencias interactivas](https://hernandez.systems/es/eventos-en-vivo)
- [Automatización y bots](https://hernandez.systems/es/automatizacion-y-bots)