twitch_dj_clipper
Bot Python para Twitch que gestiona timestamps desde chat y genera clips a partir de VODs locales usando FFmpeg. Soporta despliegue nativo o Docker, ideal para creadores que desean clips personalizados sin re-encoding.
Ficha actualizada 24 sept 2026, 12:36 · upstream 24 sept 2026, 12:34 · release v0.2
Qué es twitch_dj_clipper
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
twitch_dj_clipper es una herramienta de línea de comandos diseñada para automatizar la creación de clips en Twitch. Funciona mediante un bot que escucha el chat y guarda marcas temporales cuando usuarios con permisos (o todos, según config) ejecutan comandos como !clip. Estos timestamps se almacenan en archivos de texto para ser procesados posteriormente por un generador de clips independiente.
El sistema utiliza FFmpeg para cortar los segmentos de video desde VODs locales previamente grabados. Permite configurar la duración del clip, el tiempo antes del timestamp y metadatos como artista o título. Se puede ejecutar manualmente vía Python o mediante contenedores Docker, aunque la generación de clips en Docker aún está en desarrollo según el README.
Los clips resultantes se organizan automáticamente en carpetas con nombres que incluyen fecha, título, creador y canal. La herramienta incluye comandos de utilidad como !getclip para obtener enlaces directos a los clips generados y !stick como easter egg. Es crucial configurar correctamente las credenciales de la API de Twitch y asegurar que FFmpeg esté disponible en el entorno de ejecución.
- Creación automática de clips desde marcas temporales guardadas por moderadores o espectadores.
- Generación de clips a partir de VODs locales sin re-codificación del video original.
- Automatización del proceso de edición de highlights para redes sociales.
- Gestión de enlaces directos a clips mediante comandos de chat integrados.
- Despliegue en servidores propios o contenedores Docker para múltiples canales.
- Utiliza FFmpeg con parámetros -c copy para evitar re-codificación, ahorrando recursos.
- Soporta configuración flexible vía archivo YAML (config.yaml) para adaptar comportamientos.
- Incluye comandos de chat integrados (!clip, !getclip, !stick) para interacción directa.
- Permite separar la ejecución del bot y el generador de clips en scripts distintos.
- Compatible con Docker para despliegue simplificado en entornos Linux/Windows/Mac.
- La generación de clips dentro del contenedor Docker aún no está completamente implementada según el README (wip).
- Requiere instalación manual de FFmpeg o acceso al binario en el path del sistema.
- Es una herramienta CLI, no tiene interfaz gráfica ni soporte para usuarios sin conocimientos de terminal.
- Necesita configuración previa de OAuth2 y credenciales de la API de Twitch.
- Los VODs deben estar previamente descargados localmente para procesarse.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar Python 3 y FFmpeg antes del despliegue. Configurar OAuth2 en Twitch con redirect a localhost. Copiar example_config.yaml a config.yaml y ajustar credenciales, paths de VODs y permisos de chat. Para Docker, montar volúmenes para configs, timestamps, clips y vods. Ejecutar start_twitchbot para el bot y start_clip_generator manualmente o vía scripts OS específicos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.