# Lecture Downloader
A Python toolkit for transcribing video and audio files using Whisper AI.
## Installation
```bash
pip install lecture-downloader
```
**Requirements:**
- Python 3.8+
- FFmpeg (automatically downloaded on first use)
## Usage
### Transcribe a Single File
```bash
# 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
```bash
# 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
```bash
# 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
```
## Requirements
- Python 3.8+
- FFmpeg (automatically downloaded on first use)
## License
MIT License - see LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/dan-dev-ml/lecture-downloader",
"name": "lecture-downloader",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "education, video, transcription, canvas, brightspace, whisper, lecture",
"author": "dan-dev-ml",
"author_email": "dan-dev-ml <dan.dev.ml@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c1/09/f74a75c845b2a14b1a12f1a13f3e2fa557c489e6a0b7b276230fbbe50621/lecture_downloader-1.1.8.tar.gz",
"platform": null,
"description": "# Lecture Downloader\n\nA Python toolkit for transcribing video and audio files using Whisper AI.\n\n## Installation\n\n```bash\npip install lecture-downloader\n```\n\n**Requirements:**\n- Python 3.8+\n- FFmpeg (automatically downloaded on first use)\n\n## Usage\n\n### Transcribe a Single File\n```bash\n# Basic transcription\nlecture-downloader transcribe video.mp4\n\n# Specify output directory\nlecture-downloader transcribe video.mp4 -o transcripts/\n\n# Choose language\nlecture-downloader transcribe video.mp4 --language es\n```\n\n### Transcribe a Directory\n```bash\n# Transcribe all videos in a directory\nlecture-downloader transcribe /path/to/videos/\n\n# Transcribe with custom output location\nlecture-downloader transcribe /path/to/videos/ -o /path/to/transcripts/\n```\n\n### Options\n| Option | Description | Default |\n|--------|-------------|---------|\n| `-o, --output` | Output directory for transcripts | Same as input |\n| `--language` | Language code (en, es, fr, etc.) | `en` |\n| `--method` | Transcription method | `whisper` |\n| `--inject` | Inject subtitles into video files | `True` |\n| `--verbose` | Show detailed progress | `False` |\n\n### Examples\n```bash\n# Transcribe with all options\nlecture-downloader transcribe lectures/ \\\n --output transcripts/ \\\n --language en \\\n --inject \\\n --verbose\n\n# Transcribe without injecting subtitles\nlecture-downloader transcribe video.mp4 --no-inject\n```\n\n## Requirements\n\n- Python 3.8+\n- FFmpeg (automatically downloaded on first use)\n\n## License\n\nMIT License - see LICENSE file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A comprehensive toolkit for downloading, merging, and transcribing lecture videos",
"version": "1.1.8",
"project_urls": {
"Bug Tracker": "https://github.com/dan-dev-ml/lecture-downloader/issues",
"Documentation": "https://github.com/dan-dev-ml/lecture-downloader#readme",
"Homepage": "https://github.com/dan-dev-ml/lecture-downloader",
"PyPI": "https://pypi.org/project/lecture-downloader/",
"Repository": "https://github.com/dan-dev-ml/lecture-downloader"
},
"split_keywords": [
"education",
" video",
" transcription",
" canvas",
" brightspace",
" whisper",
" lecture"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e18e7fb161f8e34eb36547243abe22537a4e6f5d67e33e9d9b28e8ade8eafcab",
"md5": "2df3a5ab49f461383f8090eb0841e5d0",
"sha256": "1065e4dc6b1391eb2d7353bf7341f6b6a3bd6850b3472245841733ec31afd6db"
},
"downloads": -1,
"filename": "lecture_downloader-1.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2df3a5ab49f461383f8090eb0841e5d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 43089,
"upload_time": "2025-07-19T01:16:32",
"upload_time_iso_8601": "2025-07-19T01:16:32.680259Z",
"url": "https://files.pythonhosted.org/packages/e1/8e/7fb161f8e34eb36547243abe22537a4e6f5d67e33e9d9b28e8ade8eafcab/lecture_downloader-1.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c109f74a75c845b2a14b1a12f1a13f3e2fa557c489e6a0b7b276230fbbe50621",
"md5": "facb5d7953069ac2260e0f9d7074ce29",
"sha256": "1489928406ee2ee61d8b65b883c8b75fbb4c3ce8613303d13ab44abc106a3396"
},
"downloads": -1,
"filename": "lecture_downloader-1.1.8.tar.gz",
"has_sig": false,
"md5_digest": "facb5d7953069ac2260e0f9d7074ce29",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 763179,
"upload_time": "2025-07-19T01:16:33",
"upload_time_iso_8601": "2025-07-19T01:16:33.782522Z",
"url": "https://files.pythonhosted.org/packages/c1/09/f74a75c845b2a14b1a12f1a13f3e2fa557c489e6a0b7b276230fbbe50621/lecture_downloader-1.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-19 01:16:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dan-dev-ml",
"github_project": "lecture-downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
">=",
"7.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"10.0"
]
]
},
{
"name": "faster-whisper",
"specs": [
[
"==",
"1.1.1"
]
]
},
{
"name": "google-cloud-speech",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "google-cloud-storage",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "ffmpeg-python",
"specs": [
[
">=",
"0.2.0"
]
]
},
{
"name": "watchdog",
"specs": [
[
">=",
"2.0"
]
]
}
],
"lcname": "lecture-downloader"
}
JSON
