Video to Text Transcription

This project provides a tool for transcribing audio and video content using the OpenAI Whisper model.

Setup

1. Install Dependencies

Install Whisper

pip install -U openai-whisper

Install FFmpeg

ffmpeg is a powerful tool to handle multimedia data. It's required for extracting audio from video.

# on Ubuntu or Debian
sudo apt update && sudo apt install ffmpeg

# on Arch Linux
sudo pacman -S ffmpeg

# on MacOS using Homebrew (https://brew.sh/)
brew install ffmpeg

# on Windows using Chocolatey (https://chocolatey.org/)
choco install ffmpeg

# on Windows using Scoop (https://scoop.sh/)
scoop install ffmpeg

Install Rust (if needed)

In some cases, you might need Rust to be installed, especially if some dependencies don't provide pre-built binaries.

Follow the Getting started page to install Rust. You might need to set up your PATH:

export PATH="$HOME/.cargo/bin:$PATH"

If you encounter the error No module named 'setuptools_rust', install setuptools_rust:

pip install setuptools-rust

Install MoviePy

MoviePy is a Python module for video editing, which can also be used for opening and modifying video files.

pip install moviepy

2. Clone the Repository

git clone [REPOSITORY LINK]
cd [REPOSITORY NAME]

Usage

Display Help

python v2t.py --help

Transcribe Video

python v2t.py --task video --video path_to_video_file.mp4 --output_dir desired_output_directory

Transcribe Audio

python v2t.py --task audio --audio path_to_audio_file.wav --output_dir desired_output_directory

Specify Model

python v2t.py --task audio --audio path_to_audio_file.wav --model model_name

Output Format

python v2t.py --task audio --audio path_to_audio_file.wav --output_format txt

Language Specification

python v2t.py --task audio --audio path_to_audio_file.wav --language es

Translate to English

python v2t.py --task audio --audio path_to_audio_file.wav --translate

Silence Output

python v2t.py --task audio --audio path_to_audio_file.wav --verbose false

Combine arguments as needed. For example, to transcribe a Spanish video, save the results as a txt file, and translate it to English

python v2t.py --task video --video path_to_video_file.mp4 --language es --output_format txt --translate

autumnfallenwang / video_to_text Goto Github PK

video_to_text's Introduction