Skip to content

Automatically generate and overlay subtitles for any video.

License

Notifications You must be signed in to change notification settings

zaltinsoy/AutoSubZ

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Automatic subtitles in your videos

This is a fork of auto_subtitle developed by m1guelpf. The main difference in AutoSubZ is the addition of several features, such as .vtt and .txt output, along with fixes for various bugs.

This repository uses ffmpeg and OpenAI's Whisper to automatically generate and overlay subtitles on any video.

Installation

To get started, you'll need Python 3.8 or newer. Install the binary by running the following command:

pip install git+https://github.com/zaltinsoy/AutoSubZ.git

You'll also need to install ffmpeg, which is available from most package managers:

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

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

# on Windows using Winget
winget install -e --id Gyan.FFmpeg

Usage

The following command will generate a subtitled/video.mp4 file contained the input video with overlayed subtitles.

auto_subtitle /path/to/video.mp4 -o subtitled/

The default setting (which selects the small model) works well for transcribing English. You can optionally use a bigger model for better results (especially with other languages). The available models are tiny, tiny.en, base, base.en, small, small.en, medium, medium.en, large.

auto_subtitle /path/to/video.mp4 --model medium

Adding --task translate will translate the subtitles into English:

auto_subtitle /path/to/video.mp4 --task translate

Run the following to view all available options:

auto_subtitle --help

License

This script is open-source and licensed under the MIT License. For more details, check the LICENSE file.

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%