Skip to main content

Download YouTube videos, generate and translate subtitles

Project description

yt-srt-gen

yt-srt-gen is a Python tool for downloading YouTube videos, generating subtitles using OpenAI Whisper, and translating them into another language (e.g., English) automatically.

Features

  • Download YouTube videos using yt-dlp.
  • Generate subtitles with OpenAI Whisper.
  • Translate subtitles to a target language using googletrans.
  • Supports multiple subtitle formats: srt, vtt, txt, tsv, json.

Installation

You can install yt-srt-gen via pip:

pip install git+https://github.com/fertkir/yt-srt-gen.git

Or clone the repository and install manually:

git clone https://github.com/fertkir/yt-srt-gen.git
cd yt-srt-gen
pip install .

Usage

yt-srt-gen <YouTube URL> [OPTIONS]

Arguments

  • <YouTube URL>: URL of the YouTube video.

Options

  • --source-language, -s: Language spoken in the audio.
  • --target-language, -t: Language for translated subtitles.
  • --output-format, -f: Subtitle output format (txt, vtt, srt, tsv, json, all, default: srt).
  • --whisper-args, -w: Additional arguments to pass to openai-whisper.

Examples

yt-srt-gen https://www.youtube.com/watch?v=dQw4w9WgXcQ --source-language es --target-language en --output-format srt
yt-srt-gen https://www.youtube.com/watch?v=dQw4w9WgXcQ -s sr -t en -w "--model small --fp16 False"

This will download the video, generate Spanish subtitles, and append English translations.

Dependencies

  • yt-dlp - for downloading YouTube videos.
  • openai-whisper - for automatic subtitle generation.
  • googletrans - for translating subtitles.
  • tqdm - for showing progress bars.

License

This project is licensed under the GPL-3.0-or-later license.

Author

Kirill Fertikov — kirill.fertikov@gmail.com

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

yt_srt_gen-0.1.3.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yt_srt_gen-0.1.3-py3-none-any.whl (16.3 kB view details)

Uploaded Python 3

File details

Details for the file yt_srt_gen-0.1.3.tar.gz.

File metadata

  • Download URL: yt_srt_gen-0.1.3.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for yt_srt_gen-0.1.3.tar.gz
Algorithm Hash digest
SHA256 d6247191ec637eea616456541ab6e50423b15f0d1f547e45e3c1f66c3a5bdd93
MD5 bcf2ea0e9501560a1a48c7a15563276c
BLAKE2b-256 26a562cf0cbc9da352a46abac03e86145681c94d2b58a975dc21d21681f90833

See more details on using hashes here.

File details

Details for the file yt_srt_gen-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: yt_srt_gen-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 16.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for yt_srt_gen-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 68cd6a8950d522cf2c5a28c02d36b3475c0e190b2bfd05607d34e3ed73a9510e
MD5 332a0f3e0e43b1e299d62eee403ad70e
BLAKE2b-256 fa0574f08acae1b864a5e294be9d1ae757f9358c5e76c246003f4418a6e8e0db

See more details on using hashes here.

Supported by

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