Automatically generate and embed subtitles into your videos
Project description
Automatic subtitles in your videos
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.7 or newer. Install the binary by running the following command:
pip install git+https://github.com/m1guelpf/auto-subtitle.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 Chocolatey (https://chocolatey.org/)
choco install 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file auto_subtitle-1.0.1.tar.gz
.
File metadata
- Download URL: auto_subtitle-1.0.1.tar.gz
- Upload date:
- Size: 4.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9c7ddf952678c92a2c5a5466637ebeb7ccc37c92158bf0393390738d20464f2 |
|
MD5 | 2778e6aad24164ee50e1517a1b586212 |
|
BLAKE2b-256 | 07224df7595ae0350f01884df5a1761af504a523998b9e4af7429005fe3d5000 |