Repolode
0xSero

0xSero/video-edit

Un kit de scripts y una skill para agentes que transforma una grabación de pantalla de macOS sin editar en un video conciso, con datos sensibles ocultos y listo para subir, con render verificado.

Estrellas
85
Forks
4
Issues abiertos
0
Último commit
hace 3 días

¿Qué es?

video-edit es un conjunto de scripts de Python y ffmpeg, junto con una skill para agentes, que transforma una grabación de pantalla de macOS de 45–90 minutos (OBS, pantalla con webcam) en un video de 20–30 minutos listo para subir. El flujo de trabajo se basa en una transcripción: un agente decide qué fragmentos conservar, y los scripts crean una lista de decisiones de edición, renderizan el video y comprueban el resultado. Todo se ejecuta localmente.

El kit aborda problemas habituales de las grabaciones sin editar: los tramos largos de pantallas visualmente estáticas, que se detectan mediante análisis de diferencias entre fotogramas y no por el silencio; las pausas, que solo se acortan cuando el audio mejorado tiene poco volumen; y el texto sensible, como nombres de host o claves de API, que se cubre con ventanas de desenfoque y luego se comprueba mediante OCR en el resultado renderizado. Se usa Apple Vision para detectar manos en distintas poses y rostros, y señalar segmentos candidatos para su revisión. El audio pasa por reducción de ruido con DeepFilterNet3, ecualización, eliminación de sibilancias, compresión y normalización de volumen en dos pasadas a −16 LUFS.

Los renders se pueden reanudar por grupos, y un script de verificación vuelve a calcular la cantidad de fotogramas esperada, compara la duración de las pistas de audio y ejecuta de nuevo el OCR sobre el archivo final; si detecta alguna filtración, termina con un código distinto de cero. Un script de selftest ejecuta todo el flujo con una grabación sintetizada.

Funciones clave

  • 01Fragmentos que se conservan y cortes para proteger la privacidad definidos a partir de la transcripción en un único archivo job.json.
  • 02Detección de pantallas estáticas mediante diferencias entre fotogramas, independiente de la detección de silencio.
  • 03Desenfoque de todo el panel para ocultar texto sensible, seguido de OCR del resultado renderizado para confirmar que no haya filtraciones.
  • 04Cadena de procesamiento de audio con reducción de ruido de DeepFilterNet3 y loudnorm en dos pasadas a -16 LUFS.
  • 05Renderizado h264 por grupos, reanudable en macOS con VideoToolbox, junto con una etapa de verificación.

Casos de uso

  • Recortar una grabación larga de pantalla en OBS de una sesión de programación o una demostración para convertirla en un video más corto para YouTube.
  • Ocultar nombres de host, tokens u otros secretos visibles en pantalla antes de publicar una grabación.
  • Eliminar tramos sin actividad y acortar las pausas de charlas grabadas en una Mac.

Inicio rápido

  1. 1

    Clona el repositorio en el directorio de skills de tu agente

    git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit
  2. 2

    Instala las dependencias de Python

    python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz
  3. 3

    Comprueba la instalación ejecutando la prueba automática con una grabación sintetizada

    bash scripts/selftest.sh /tmp/ved-selftest

Antes de usarlo

  • Requiere macOS 14 o posterior; Linux no es compatible tal cual.
  • Está diseñado para un flujo de grabación de pantalla en macOS específico, al estilo de OBS.
  • Requiere tener ffmpeg 6.0 o posterior y Python 3.10 o posterior instalados por separado.

En colecciones

Temas

Preguntas frecuentes

¿Qué es video-edit?
Un kit de scripts y una skill para agentes que transforma una grabación de pantalla de macOS sin editar en un video conciso, con datos sensibles ocultos y listo para subir, con render verificado. video-edit es un conjunto de scripts de Python y ffmpeg, junto con una skill para agentes, que transforma una grabación de pantalla de macOS de 45–90 minutos (OBS, pantalla con webcam) en un video de 20–30 minutos listo para subir. El flujo de trabajo se basa en una transcripción: un agente decide qué fragmentos conservar, y los scripts crean una lista de decisiones de edición, renderizan el video y comprueban el resultado. Todo se ejecuta localmente.
¿video-edit es gratuito? ¿Qué licencia tiene?
video-edit es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿video-edit sigue mantenido?
Mantenimiento activo. El último commit de video-edit fue el 4 nov 2026.
¿Para qué puedo usar video-edit?
Recortar una grabación larga de pantalla en OBS de una sesión de programación o una demostración para convertirla en un video más corto para YouTube. Ocultar nombres de host, tokens u otros secretos visibles en pantalla antes de publicar una grabación. Eliminar tramos sin actividad y acortar las pausas de charlas grabadas en una Mac.
¿Cómo se instala video-edit?
Clona el repositorio en el directorio de skills de tu agente: git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit Instala las dependencias de Python: python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz Comprueba la instalación ejecutando la prueba automática con una grabación sintetizada: bash scripts/selftest.sh /tmp/ved-selftest
¿Dónde consigo video-edit?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/0xSero/video-edit

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados