https://github.com/bashonly/yt-dlp-ytcustomchapters
A yt-dlp extractor plugin for using custom Youtube chapter lists
https://github.com/bashonly/yt-dlp-ytcustomchapters
yt-dlp yt-dlp-plugins
Last synced: 3 months ago
JSON representation
A yt-dlp extractor plugin for using custom Youtube chapter lists
- Host: GitHub
- URL: https://github.com/bashonly/yt-dlp-ytcustomchapters
- Owner: bashonly
- License: unlicense
- Created: 2024-03-26T05:21:12.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-26T05:25:31.000Z (about 1 year ago)
- Last Synced: 2025-01-24T20:35:04.598Z (5 months ago)
- Topics: yt-dlp, yt-dlp-plugins
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
README
A [yt-dlp](https://github.com/yt-dlp/yt-dlp) extractor [plugin](https://github.com/yt-dlp/yt-dlp#plugins) for using custom Youtube chapter lists
---
## Usage
Pass `--extractor-args "youtube:chapters_file=/path/to/chapters.txt"` with your yt-dlp command to have the Youtube extractor parse the given text file for chapters.
The text file should be formatted with 1 chapter per line, with a line structure of `START:TIME Chapter Name`, e.g.:
```
00:00 Introduction
01:15 Beginning
02:40 Middle
04:20 End
```
## Installation
Requires yt-dlp `2023.01.02` or above.
You can download the wheel of the [latest release](https://github.com/bashonly/yt-dlp-YTCustomChapters/releases/latest) and place the `.whl` file in one of [yt-dlp's plugin paths](https://github.com/yt-dlp/yt-dlp#installing-plugins).
Or you can install this package with pip:
```
python3 -m pip install -U https://github.com/bashonly/yt-dlp-YTCustomChapters/archive/master.zip
```
See [the plugins section of the yt-dlp README](https://github.com/yt-dlp/yt-dlp#installing-plugins) for more information.