# 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/28/d0/88856581767b73abdea6d5f6c13463cc41b4f5944254cb6562ee04d01313/lecture_downloader-1.1.10.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.10",
"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": "054504e857acdaa8f2d692f34fe106c4871d439e8c08621d3af04af3f1414a6d",
"md5": "bda6e0c5af298018303d426d932a1b17",
"sha256": "4f4a35d62574fbfdbc41df0fdb8164dbac3d344b45e6449c749ad9fed3b6576e"
},
"downloads": -1,
"filename": "lecture_downloader-1.1.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bda6e0c5af298018303d426d932a1b17",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 43323,
"upload_time": "2025-10-17T01:35:07",
"upload_time_iso_8601": "2025-10-17T01:35:07.431714Z",
"url": "https://files.pythonhosted.org/packages/05/45/04e857acdaa8f2d692f34fe106c4871d439e8c08621d3af04af3f1414a6d/lecture_downloader-1.1.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "28d088856581767b73abdea6d5f6c13463cc41b4f5944254cb6562ee04d01313",
"md5": "4217aba94bf226d9af67a866ea3cd16c",
"sha256": "8cf578e4ba4c4657aad562a6728c408e0f95fbc0ca0fbefee43a6611048fd7ba"
},
"downloads": -1,
"filename": "lecture_downloader-1.1.10.tar.gz",
"has_sig": false,
"md5_digest": "4217aba94bf226d9af67a866ea3cd16c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 763476,
"upload_time": "2025-10-17T01:35:08",
"upload_time_iso_8601": "2025-10-17T01:35:08.982397Z",
"url": "https://files.pythonhosted.org/packages/28/d0/88856581767b73abdea6d5f6c13463cc41b4f5944254cb6562ee04d01313/lecture_downloader-1.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-17 01:35:08",
"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
