Video Review Notes: un visor de vídeos con gestor de notas pensado para exportárselas a un agente IA

Estas semanas he estado preparando los vídeos promocionales de EchoControl.

Cada pieza sale en varias versiones, con distintas voces, en inglés y en español y en más de un formato, así que al final tenía una carpeta con treinta y tantos archivos que revisar uno a uno antes de publicarlos.

Son vídeos que enseñan cómo controlar un videojuego con comandos de voz: el trabajo es indicarle a un agente cuándo reubicar un comando que entra demasiado pronto, subir una voz que queda por debajo de la música, renombrar un archivo o descartar otro, etc.

El proceso era una lata. Abría el vídeo, lo paraba, apuntaba el segundo en un bloc de notas y volvía al reproductor. Luego tenía que pasarle esas notas al agente que hace las correcciones, una por una y diciéndole siempre a qué archivo se refería cada cosa.

Con nombres como shadow-tactics_2026-10-08_voz1-reel-distraer_youtube_Callum_final-86.mp4 es facilísimo equivocarse de vídeo.

Lo que yo quería era bastante concreto: una herramienta de revisión de vídeo local, sin subir nada a la nube, donde ver la lista de vídeos, reproducirlos y escribir anotaciones con marcas de tiempo pegadas a cada archivo.

Y al final un botón que juntara todas las notas en un único documento, ordenado por vídeo, que un agente de IA pudiera leer sin tener que interpretar nada.

Algo parecido a las plataformas de video review y aprobación que se usan en postproducción, pero con un destinatario distinto: en lugar de un editor, un agente que ejecuta las instrucciones.

Primero con ChatGPT, luego con Claude Code

No empecé escribiendo código. Le conté la necesidad a ChatGPT tal cual, con mis palabras, y estuvimos dándole vueltas hasta tener claro qué tenía que hacer sí o sí y qué se quedaba fuera.

De ahí salió un prompt detallado para Claude, con criterios de aceptación y una lista de cosas que no había que tocar: nada de editar vídeo, nada de transcripciones y nada de cuentas de usuario.

Ese prompt fijaba unas prioridades muy claras y creo que fue lo que más ayudó. Primero, que los vídeos se reprodujeran bien. Después, que las notas no se perdieran nunca y que cada instrucción quedara ligada sin ambigüedad a su archivo. La estética iba al final de la lista.

Claude Code lo montó como una aplicación local en Python con la interfaz en el navegador. Se arranca con un .bat, lee la carpeta que le indicas y guarda las notas en un video_review.json que se escribe de forma segura y con copia de respaldo. Los vídeos no se modifican en ningún momento, solo se leen.

Las notas se guardan solas mientras escribes, y un botón inserta el tiempo exacto del reproductor donde tengas el cursor, del estilo de [00:00:21] Salto de imagen en la transición.

Todo la herramienta salió en una única sesión de dos o tres horas. La primera versión funcional estuvo lista enseguida – unos 10 minutos, y a partir de ahí fui pidiendo cambios sobre la marcha, mientras la probaba con mis propios vídeos: reproducción automática al elegir un vídeo, miniaturas, buscador por nombre, ordenar pinchando en las cabeceras de la tabla o un reloj que no desaparece cuando los controles del reproductor se esconden.

Lo primero que pedí fue un rediseño rápido:

Lo que más me sigue llamando la atención es el ritmo.

Cada petición tardaba unos pocos minutos en estar hecha y probada, porque Claude Code pasaba sus pruebas automáticas y comprobaba el resultado en el navegador antes de darla por buena. Si veía un fallo, como un desplegable de idiomas que se mezclaba con otro, se lo enseñaba con una captura y en la siguiente vuelta estaba corregido. Así se encadenan decenas de cambios pequeños en cada iteración, cuando con un desarrollo normal cada uno de ellos habría llevado su rato.

De esas rondas salieron también los atajos de teclado, que es lo que más uso cuando reviso de un tirón:

Alt+K       play / pausa
Alt+J / L   retroceder / avanzar 5 segundos
Alt+, / .   bajar / subir la velocidad (0,5× a 2×)
Alt+B / N   vídeo anterior / siguiente
Alt+T       insertar el tiempo actual en las notas
Alt+R       marcar o desmarcar como revisado

Todos llevan Alt para que funcionen también mientras escribes en el cuadro de notas, que es justo cuando más falta hacen.

Los ajustes, la parte que más me ha sorprendido

Lo que empezó como un visor con un cuadro de texto acabó, en esa misma sesión, con un panel de ajustes bastante completo. Ninguna de estas opciones estaba en el planteamiento inicial. Fueron saliendo según probaba la herramienta, y cada una estaba lista en minutos:

• Distribución: la pantalla tiene tres zonas (lista, vídeo y notas). Puedes elegir cuál va en cada sitio y arrastrar las barras que las separan para cambiar anchos y altos.
• Dónde se guardan las notas: junto a los vídeos o en otra carpeta, para que la de vídeos quede intacta. Si cambias de opción, las notas se van con ellas.
• Formato de exportación: TXT por defecto, Markdown o JSON si el agente va a procesarlo con un programa. Cada exportación genera un solo archivo.
• Miniaturas: se sacan del segundo 8 para saltarse las intros, y si el vídeo dura menos, de su mitad. Si el ordenador no tiene ffmpeg instalado, la miniatura la genera el propio navegador.
• Apariencia: modo noche por defecto, modo día y seis colores de acento.
• Idioma: español, inglés, francés, italiano y alemán.

Aquí ejemplos de todo lo anterior:

Lo de la carpeta aparte tiene su miga. Si cambias de opción a mitad de trabajo y sigues anotando, la aplicación compara los dos ficheros de notas y se queda con el más reciente, así que no pueden reaparecer notas antiguas. Ese detalle no lo pedí yo: apareció al revisar el primer diseño de la función, y se corrigió antes de darla por terminada.

De momento, para uso propio

Ahora mismo lo uso yo, para los vídeos de EchoControl, y el flujo ha cambiado bastante.

• Reviso la carpeta entera de seguido,
• exporto un TXT con todas las instrucciones
• y se lo paso al agente que hace los cambios.

Ya no copio notas a mano ni tengo que explicar a qué archivo me refiero en cada caso.

No descarto publicarlo para que lo pueda usar más gente. Quien revise lotes de vídeo y trabaje con agentes de IA se va a encontrar con el mismo problema, y una herramienta que funciona en local y no sube nada a ningún servidor tiene su hueco. Incluso podría comercializarlo a un precio bajo.

Antes le toca una vuelta de diseño, que este «huele mucho a IA», pero eso ya da para otro post.

Tags: echocontrol