ChimaOzonwoye/script-to-vid

¿Qué hace script-to-vid?

Herramienta gratuita para videos que nunca tendrás que filmar ni editar. Escribe lo que quieras que se diga y obtén un video terminado: una voz de IA lo lee en voz alta, se reproduce animación y los subtítulos se muestran en pantalla. Ideal para explicar un producto, una demostración, un canal sin rostro, una lección o una presentación. Completamente gratuito.

¿Cómo Funciona?

Esta habilidad permite que un agente de IA convierta texto en un video completo usando únicamente herramientas de línea de comandos y librerías open-source. El proceso es el siguiente:

1. Escribe tu guion: Proporciona el texto que deseas que se narre en el video.
2. Generación automática: El agente utiliza la librería say.js (o espeak en Linux) para convertir el texto en audio con una voz de IA, y remotion para crear una animación simple con subtítulos sincronizados.
3. Video terminado: Se produce un archivo de video (formato MP4) listo para compartir.

Casos de Uso

• Explicación de producto: Describe las características de tu producto mientras se muestra una animación relevante.
• Demostración: Muestra cómo usar una herramienta o servicio sin necesidad de grabar pantalla.
• Canal sin rostro: Crea contenido para YouTube o redes sociales sin aparecer en cámara.
• Lecciones educativas: Genera videos de aprendizaje con narración y subtítulos.
• Presentaciones: Prepara pitch decks en video de forma rápida.

Requisitos

• Node.js (versión 16 o superior)
• FFmpeg (para procesamiento de video)
• Navegador Chromium (para remotion, se instala automáticamente si es necesario)

Instalación

npm install -g script-to-vid

O ejecútalo directamente con npx:

npx script-to-vid --script "Tu guion aquí"

Uso Básico

Desde la línea de comandos:

script-to-vid --script "Bienvenido a este video demo. Esta herramienta te permite crear contenido sin esfuerzo." --output demo.mp4

Opciones adicionales:

• --voice: Seleccionar la voz (por defecto: "es-MX-SoniaNeural" para español).
• --background: Color de fondo o imagen (por defecto: "#1a1a2e").
• --captions: Habilitar/deshabilitar subtítulos (por defecto: true).
• --speed: Velocidad de lectura (0.5 a 2.0, por defecto: 1.0).

Integración con Agentes de IA

Para usar esta habilidad en Claude Code, Cursor o Codex, simplemente proporciona el comando adecuado al agente. Por ejemplo:

Claude, usa script-to-vid para crear un video de 30 segundos explicando los beneficios de la IA generativa.

El agente ejecutará la herramienta y te devolverá el archivo de video generado.

Ejemplo de Salida

🎬 Video generado exitosamente: demo.mp4
Duración: 45 segundos
Formato: 1920x1080 a 30fps

Licencia

MIT - Totalmente gratuito y open-source.

Soporte

Si encuentras algún problema, abre un issue en el repositorio de GitHub o consulta la documentación oficial en https://github.com/ChimaOzonwoye/script-to-vid.