Skip to main content

Language learning application that uses openai's whisper to generate foreign language and English subtitles for videos simultaneously to help with language learning.

Installation

> pip install llsubtitles

Usage

To use llsubtitles first you need a foreign language .mp4 file. I recommend using yt-dlp to download content for language learning. Once you have a .mp4 file you can use llsubtitles to generate subtitles for it.

# Using chinese content for this example
> llsubtitles --language Chinese --model small --combined --definitions --pinyin example.mp4

--language: Refers to the language used by openai's whisper to generate subtitles.
--model: The model used by whisper. See their documentation for more options.
--combined: If this flag is used, the subtitles will be generated in both the foreign language and English.
--definitions: If this flag is used, the subtitles will include definitions for the foreign language words.
--pinyin: Optional flag for Chinese learners, if this flag is used, the subtitles will include pinyin for the Chinese words.

Note, you should make sure that you have pytorch set up correctly to use Cuda if you're using an Nvidia GPU. See pytorch's documentation for more information. This will greatly improve performance.

Credits

Chinese English dictionary is courtesy of cedict

Metadata

Release files for llsubtitles 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for llsubtitles 1.0.1
File Size Uploaded
llsubtitles-1.0.1.tar.gz 3.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for llsubtitles 1.0.1
File Interpreter ABI Platform
llsubtitles-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 7.4 MB

Release files / llsubtitles-1.0.1.tar.gz

Download URL llsubtitles-1.0.1.tar.gz
Size 3.6 MB
Tags Source
SHA-256 checksum
How to use checksums
2a8552f113a6551a4508984d14958897d0cb2813f59f32a94ae765c082b809f8
BLAKE2b-256 checksum
How to use checksums
83337c82df327b1b380d000bee1f98ff51939067dca291d1a69be3737d838132
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.3.2 CPython/3.8.10 Linux/5.10.16.3-microsoft-standard-WSL2

Release files / llsubtitles-1.0.1-py3-none-any.whl

Download URL llsubtitles-1.0.1-py3-none-any.whl
Size 3.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
af26f21e0cef99321ca18fe959abfeae5e255e33ada52762c86698b1d2e6f8aa
BLAKE2b-256 checksum
How to use checksums
35b2d758a27c0465ebc6e4ffef7d4745bfd5032552ac573bffdcc79d63466f9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.3.2 CPython/3.8.10 Linux/5.10.16.3-microsoft-standard-WSL2

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page