Transcripción de Videos

Transcripción de Videos es una herramienta que permite convertir un archivo de video en formato .mp4 en un archivo de texto con la transcripción completa del contenido hablado.
Es ideal para tomar notas, analizar contenido o extraer información de manera eficiente.

🧰 Requisitos

Antes de comenzar, asegúrate de tener instaladas las siguientes herramientas en tu equipo:

• Python
  Se recomienda instalar Python utilizando asdf, un gestor de versiones que facilita su manejo en distintos entornos.

  asdf install

• ffmpeg
  Utilizado para la extracción de audio desde archivos .mp4. Puede instalarse, por ejemplo, con Homebrew:

  brew install ffmpeg

⚙️ Instalación

1. Clona el repositorio y entra en la carpeta del proyecto:

   cd transcript

2. Ejecuta el siguiente comando para instalar las dependencias:

   make install

   Esto creará un entorno virtual de Python y descargará automáticamente todas las dependencias necesarias para el proyecto.

🚀 Uso

Para transcribir un archivo .mp4, ejecuta el siguiente comando:

make transcript-mp4 MP4_FILE=/ruta/al/video.mp4 AUDIO_FILE=/ruta/al/audio.wav TRANSCRIPT_FILE=/ruta/a/la/transcripcion.txt

Parámetros

• MP4_FILE: Ruta absoluta al archivo de video .mp4.
• AUDIO_FILE: Ruta donde se guardará el archivo .wav extraído del video.
• TRANSCRIPT_FILE: Ruta donde se guardará el archivo .txt con la transcripción del contenido.
• WHISPER_MODEL (opcional): Nombre del modelo de Whisper a utilizar para la transcripción. Por defecto, se utiliza el modelo base. Otros valores posibles incluyen small, medium, o large. Modelos más grandes ofrecen mayor precisión pero requieren más recursos.

🚧 Limitaciones

• La transcripción no discrimina entre diferentes actores o hablantes en el video. Todo el contenido hablado se transcribe como un único flujo de texto.
• Los videos pueden contener mucha información visual que no es capturada en la transcripción, ya que esta se enfoca únicamente en el contenido hablado.

📄 Licencia

Este proyecto está licenciado bajo la MIT License.
Puedes usarlo, modificarlo y distribuirlo libremente, siempre que mantengas los créditos originales.

👥 Contribuidores

Agradecemos a todas las personas que han contribuido a este proyecto. Sus aportes son esenciales para su desarrollo y mejora.

Si deseas unirte como contribuidor, por favor revisa nuestra Guía de Contribución para más detalles sobre cómo empezar.