# yt-transcript-fetcher | YouTube Transcript Fetcher
[](https://github.com/SootyOwl/yt-transcript-fetcher/actions/workflows/run-tests.yml)
[](https://pypi.org/project/yt-transcript-fetcher/)
A python package to fetch YouTube video transcripts.
## Installation
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install yt-transcript-fetcher.
```bash
pip install yt-transcript-fetcher
```
## Usage
Basic usage examples can be found in the [examples](https://github.com/SootyOwl/yt-transcript-fetcher/tree/main/examples) directory.
### Command Line Interface (CLI)
The package includes a basic command line interface for fetching transcripts. You can run the following command:
```bash
yt-transcript-fetcher <video_id> --list-languages
```
This will list all available languages for the specified video ID.
```bash
yt-transcript-fetcher <video_id> --download <language_code>
```
This will download the transcript for the specified video ID in the given language code and output it to standard output.
### Python API
You can also use the package as a Python module. Here is a basic example:
```python
from yt_transcript_fetcher import list_languages, get_transcript
video_id = "dQw4w9WgXcQ" # Replace with your video ID
languages = list_languages(video_id)
print("Available languages:", languages)
transcript = get_transcript(video_id, language_code="en")
print("Transcript:", transcript)
```
## Contributing
Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": null,
"name": "yt-transcript-fetcher",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "caption, captions, subtitle, subtitles, transcript, transcripts, video, youtube, youtube-api, youtube-subtitles, youtube-transcripts, yt, yt-transcript",
"author": null,
"author_email": "Dan Eagle <dan@tyto.cc>",
"download_url": "https://files.pythonhosted.org/packages/c3/83/5928687922fb1f06327bdcf07e866b1849439f918d57769f55a71a6ad500/yt_transcript_fetcher-1.2.0.tar.gz",
"platform": null,
"description": "# yt-transcript-fetcher | YouTube Transcript Fetcher\n\n[](https://github.com/SootyOwl/yt-transcript-fetcher/actions/workflows/run-tests.yml)\n[](https://pypi.org/project/yt-transcript-fetcher/)\n\n\n\n\nA python package to fetch YouTube video transcripts.\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install yt-transcript-fetcher.\n\n```bash\npip install yt-transcript-fetcher\n```\n\n## Usage\n\nBasic usage examples can be found in the [examples](https://github.com/SootyOwl/yt-transcript-fetcher/tree/main/examples) directory.\n\n### Command Line Interface (CLI)\nThe package includes a basic command line interface for fetching transcripts. You can run the following command:\n\n```bash\nyt-transcript-fetcher <video_id> --list-languages\n```\n\nThis will list all available languages for the specified video ID.\n\n```bash\nyt-transcript-fetcher <video_id> --download <language_code>\n```\n\nThis will download the transcript for the specified video ID in the given language code and output it to standard output.\n\n### Python API\n\nYou can also use the package as a Python module. Here is a basic example:\n\n```python\nfrom yt_transcript_fetcher import list_languages, get_transcript\nvideo_id = \"dQw4w9WgXcQ\" # Replace with your video ID\nlanguages = list_languages(video_id)\nprint(\"Available languages:\", languages)\ntranscript = get_transcript(video_id, language_code=\"en\")\nprint(\"Transcript:\", transcript)\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first\nto discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This library can be used to fetch transcripts for YouTube videos",
"version": "1.2.0",
"project_urls": {
"CHANGELOG": "https://github.com/SootyOwl/yt-transcript-fetcher/blob/main/CHANGELOG.md",
"Home Page": "https://github.com/SootyOwl/yt-transcript-fetcher",
"Issue Tracker": "https://github.com/SootyOwl/yt-transcript-fetcher/issues",
"Release Notes": "https://github.com/SootyOwl/yt-transcript-fetcher/releases"
},
"split_keywords": [
"caption",
" captions",
" subtitle",
" subtitles",
" transcript",
" transcripts",
" video",
" youtube",
" youtube-api",
" youtube-subtitles",
" youtube-transcripts",
" yt",
" yt-transcript"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "475584947272f5dfc1236cef69f967424bbb8a723a620ef0d87d447407320c46",
"md5": "4df0bfe77611b08bbee1941f81a04579",
"sha256": "3aab07f4c5a7b81e9b2b1757dd65186d25331620f4414b2845476ed8dbeb8fb5"
},
"downloads": -1,
"filename": "yt_transcript_fetcher-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4df0bfe77611b08bbee1941f81a04579",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 12384,
"upload_time": "2025-09-04T18:01:55",
"upload_time_iso_8601": "2025-09-04T18:01:55.479537Z",
"url": "https://files.pythonhosted.org/packages/47/55/84947272f5dfc1236cef69f967424bbb8a723a620ef0d87d447407320c46/yt_transcript_fetcher-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c3835928687922fb1f06327bdcf07e866b1849439f918d57769f55a71a6ad500",
"md5": "7d96086221d74bbe9bbe661fecd74e1a",
"sha256": "4fe3cf95dd664a4e25ba1ce84280c940e92b32a9a2bc3e407724b587de6eb97f"
},
"downloads": -1,
"filename": "yt_transcript_fetcher-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "7d96086221d74bbe9bbe661fecd74e1a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 40652,
"upload_time": "2025-09-04T18:01:56",
"upload_time_iso_8601": "2025-09-04T18:01:56.755940Z",
"url": "https://files.pythonhosted.org/packages/c3/83/5928687922fb1f06327bdcf07e866b1849439f918d57769f55a71a6ad500/yt_transcript_fetcher-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-04 18:01:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SootyOwl",
"github_project": "yt-transcript-fetcher",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "yt-transcript-fetcher"
}
JSON
