Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

auto_subtitle-1.0.1.tar.gz (4.6 kB view details)

Uploaded Source

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

Hashes for auto_subtitle-1.0.1.tar.gz
Algorithm Hash digest
SHA256 d9c7ddf952678c92a2c5a5466637ebeb7ccc37c92158bf0393390738d20464f2
MD5 2778e6aad24164ee50e1517a1b586212
BLAKE2b-256 07224df7595ae0350f01884df5a1761af504a523998b9e4af7429005fe3d5000

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page