lecture-downloader

Lecture Downloader

A Python toolkit for transcribing video and audio files using Whisper AI.

Installation

pip install lecture-downloader

Requirements:

• Python 3.8+
• FFmpeg (automatically downloaded on first use)

Usage

Transcribe a Single File

# Basic transcription
lecture-downloader transcribe video.mp4

# Specify output directory
lecture-downloader transcribe video.mp4 -o transcripts/

# Choose language
lecture-downloader transcribe video.mp4 --language es

Transcribe a Directory

# Transcribe all videos in a directory
lecture-downloader transcribe /path/to/videos/

# Transcribe with custom output location
lecture-downloader transcribe /path/to/videos/ -o /path/to/transcripts/

Options

Option	Description	Default
-o, --output	Output directory for transcripts	Same as input
--language	Language code (en, es, fr, etc.)	en
--method	Transcription method	whisper
--inject	Inject subtitles into video files	True
--verbose	Show detailed progress	False

Examples

# Transcribe with all options
lecture-downloader transcribe lectures/ \
  --output transcripts/ \
  --language en \
  --inject \
  --verbose

# Transcribe without injecting subtitles
lecture-downloader transcribe video.mp4 --no-inject

Shell Completion

# Show all shell instructions
lecture-downloader completion

# Show instructions for specific shell
lecture-downloader completion bash
lecture-downloader completion zsh
lecture-downloader completion fish

Requirements

• Python 3.8+
• FFmpeg (automatically downloaded on first use)

License

MIT License - see LICENSE file for details.