Herramienta TopeRC / RadioMaster MT12
MT12OverlayStudio
Crea overlays de vídeo transparentes y precisos desde logs de telemetría de RadioMaster MT12 con editor visual, instalador de scripts Lua y exportación ProRes o PNG.
Overlays de telemetría para vídeos RC
Convierte logs de la MT12 en telemetría lista para vídeo.
MT12OverlayStudio es una herramienta de escritorio de TopeRC para vídeos de RC crawling y trail. Instala scripts logger de EdgeTX en una RadioMaster MT12, lee los CSV de telemetría resultantes, permite diseñar widgets animados sobre una previsualización y exporta un overlay transparente para componerlo en un editor.
Flujo de trabajo
De la SD de la radio al overlay en la línea de tiempo.
Instala el logger.
Conecta la MT12 por USB y deja que la app copie los scripts Lua en las carpetas correctas de EdgeTX, o cópialos manualmente desde el repositorio.
Carga una sesión.
Selecciona un CSV directamente o deja que la app escanee unidades EdgeTX conectadas y liste logs por modelo y fecha.
Diseña el overlay.
Coloca gauges, barras, gráficas y textos sobre una previsualización en vivo. Recorre la sesión para ver cómo animan los valores reales.
Renderiza para editar.
Exporta un MOV transparente con ffmpeg o una secuencia PNG para componer en DaVinci Resolve, Premiere, Final Cut o herramientas similares.
01 - Instalar
Prepara la radio.
La vista de instalación detecta la SD de la MT12 cuando puede y copia los scripts Lua incluidos a las ubicaciones correctas de EdgeTX.
02 - Cargar
Elige telemetría.
La vista de origen carga CSV manuales o escanea unidades EdgeTX conectadas para encontrar la sesión de conducción correcta.
03 - Diseñar
Construye el overlay.
Los widgets se editan directamente sobre la previsualización con controles precisos de posición, tamaño, rotación, color, sombra, fuente y tipo.
04 - Transformar
Moldea señales raw.
Los pipelines por widget pueden encadenar mínimo, máximo, media acumulada y transformaciones porcentuales para convertir valores EdgeTX raw en movimiento legible.
05 - Exportar
Renderiza vídeo transparente.
Configura FPS, tamaño de salida, ffmpeg, salida MOV o secuencias PNG y sigue el progreso fotograma a fotograma durante el render.
Logger EdgeTX
La app incluye los scripts que corren en la radio.
El repositorio incluye los scripts Lua que se ejecutan en la MT12 y escriben filas CSV desde las fuentes detectadas en la radio. La app empaqueta esos scripts como recursos extra, así que instalarlos en la radio no necesita internet.
| Archivo del repo | Destino en la SD |
|---|---|
RCLOG/RCLOGC.lua | SCRIPTS/RCLOG/RCLOGC.lua |
TELEMETRY/RCLOG.lua | SCRIPTS/TELEMETRY/RCLOG.lua |
TOOLS/RCLOG.lua | SCRIPTS/TOOLS/RCLOG.lua |
Las columnas CSV se descubren desde la radio. Los valores analógicos suelen llegar como rangos raw de EdgeTX, normalmente -1024..1024, y se transforman dentro del editor de overlays.
Especificaciones técnicas
Arquitectura interna de una app Electron.
| Capa | Tecnología |
|---|---|
| Shell | Electron con puente preload y enrutado de comandos IPC |
| Frontend | React, Vite, TypeScript, i18next y lucide-react |
| Canvas | Código compartido de dibujo de widgets para previsualización y exportación |
| Exportación | @napi-rs/canvas en el proceso principal y ffmpeg para salida MOV transparente |
| Integración radio | Detección de SD EdgeTX, instalación de scripts Lua y listado de logs |
| Widgets | Gauge, barra, gráfica y texto con pipelines de datos por widget |
| Idiomas | Inglés, español, alemán y francés seleccionables en runtime |
| Distribución | electron-builder para Windows, macOS y Linux con electron-updater |
Instalar MT12OverlayStudio
Descarga la versión para tu sistema operativo.
La app se publica desde la organización TopeRC en GitHub porque pertenece al mundo de herramientas y contenido RC, pero la mantiene dgarana.
Descarga el setup.
Usa el archivo MT12OverlayStudio-x.x.x-setup.exe de la última release.
Descarga el DMG.
Elige Apple Silicon arm64 o Intel x64 según tu Mac.
Descarga AppImage o deb.
Usa la AppImage portable o instala el paquete Debian en distribuciones compatibles.
Desarrollo
Construida como una herramienta de producción de escritorio.
npm install
npm run start:dev
npm run typecheck
npm run build
npm run smoke