https://github.com/brendancsmith/subtitler
A set of tools for transcribing video files and adding subtitles using ffmpeg and the whisper library.
https://github.com/brendancsmith/subtitler
audio-processing openai subtitles transcribe transcript transcription whisper
Last synced: 7 months ago
JSON representation
A set of tools for transcribing video files and adding subtitles using ffmpeg and the whisper library.
- Host: GitHub
- URL: https://github.com/brendancsmith/subtitler
- Owner: brendancsmith
- License: mit
- Created: 2024-09-20T03:41:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-18T18:32:04.000Z (9 months ago)
- Last Synced: 2025-04-19T07:01:18.259Z (9 months ago)
- Topics: audio-processing, openai, subtitles, transcribe, transcript, transcription, whisper
- Language: Python
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Video Subtitling Tool
This project provides a set of tools for processing video files, including extracting audio, transcribing audio to text, generating subtitles, and adding subtitles to video files. It uses the whisper library to transcribe audio.
## Installation
### ffmpeg
FFmpeg is required for processing video and audio files. Follow the instructions below to install FFmpeg on your platform.
#### Windows
1. Download the FFmpeg zip file from the [official website](https://ffmpeg.org/download.html).
2. Extract the zip file to a folder of your choice.
3. Add the `bin` folder inside the extracted folder to your system's PATH environment variable.
#### macOS
1. Install Homebrew if you haven't already:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
2. Install FFmpeg using Homebrew:
```bash
brew install ffmpeg
```
#### Linux
```bash
sudo apt update
sudo apt install ffmpeg
```
### Python Packages
```bash
pip install -r requirements.txt
```
## Usage
To process video files, run `python main.py`. By default, it processes all `.mp4` files in the `video_input` directory. You can also specify a single video file as an argument.
```bash
python main.py [video_file]
```
## Default Directories
- `assets/video_input/`: Input video files (.mp4)
- `assets/video_output/`: Output video files with subtitles (.mp4)
- `assets/audio/`: Directory for extracted audio files (.mp3)
- `assets/subtitles/`: Directory for generated subtitle files (.srt)
- `assets/text/`: Directory for transcribed text files (.txt)
## License
This project is licensed under the MIT License.