bashonly / yt-dlp-ytcustomchapters

A yt-dlp extractor plugin for using custom Youtube chapter lists

A yt-dlp extractor plugin 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 and place the .whl file in one of yt-dlp's plugin paths.

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 for more information.

yt-dlp-ytcustomchapters's Issues

This is how I installed the plugin on Windows

Just to say thank you to @bashonly for creating this useful plugin and his great support on reddit.

I'm running a portable version of yt-dlp on Windows. Belows are all the relevant files locations of my installation:

D:/yt-dlp.exe
D:/ffmpeg_6.0/bin/ffmpeg.exe
D:/ffmpeg_6.0/bin/ffmprobe.exe
I downloaded the plugin and placed it in: D:/yt-dlp-plugins/yt_dlp_ytcustomchapters-2024.3.26-py3-none-any.whl

Below is the sample yt-dlp command that works:

D:/yt-dlp.exe -P "D:/Musics/KamWan"  -o "chapter:%(section_title)s.%(ext)s" --extract-audio --audio-format mp3  --audio-quality 0 --ffmpeg-location "D:/ffmpeg-6.0/bin" --embed-metadata --extractor-args "youtube:chapters_file=D:/chapters.txt" --split-chapters "https://youtu.be/oTWqVWeENxg?si=GMH_dDbDEWTUGfDs"