chaptertool

April 11, 2025 ยท View on GitHub

chaptertool

chaptertool

Create and convert chapters for podcasts, youtube, matroska, mkvmerge/nero/vorbis, webvtt, ffmpeginfo, ffmetadata, pyscenedetect, apple chapters, edl, podlove simple chapters (xml, json), apple hls chapters and mp4chaps.

Build on @mtillmann/chapters

Web App

Click here to open the web app.

Supported Formats

namekeyextinfo
Podcasting 2.0 Chapterschaptersjsonjsonspec
FFMetadataffmpegdatatxtspec
Matroska XML chaptersmatroskaxmlxmlspec
MKVToolNix mkvmerge XMLmkvmergexmlxmlspec
MKVToolNix mkvmerge simplemkvmergesimpletxtspec
WebVTT Chapterswebvttvttspec
Youtube Chapter Syntaxyoutubetxt
FFMpegInfoffmpeginfotxtread only, used internally
PySceneDetectpyscenedetectcsvproject home
Vorbis Comment Formatvorbiscommenttxtspec
"Apple Chapters"applechaptersxmlsource
Shutter EDLedledlsource
Podigee Chapters/Chaptermarkspodigeejsonspec
Podlove Simple Chapterspscxmlspec
Podlove Simple Chapters JSONpodlovejsonjsonsource
MP4Chapsmp4chapstxtsource
Apple HLS Chaptersapplehlsjsonspec, partial support
Scenecut formatscenecutjsonsource
Audible Chapter Formataudiblejsonsource
Spotify Formats A/Bspotifya|spotifybtxtsee
Podcastpage Formatpodcastpagetxtsee
Podigee Text Formatpodigeetexttxtsee
TransistorFM Chapter Formattransistorfmtxtsee
Unknown Shownotes Formatshownotestxtsee

CLI

An updated cli tool with better interface is available here: chapconv

If you want to extract chapters from videos, rather use native ffmpeg or pyscenedetect commands and integrate chapconv in your pipeline. Here is the old CLI Documentation.

Examples & FAQ

examples.md, FAQ

Docker

Use docker to run the web GUI:

docker build -t chaptertool-gui .
docker run -p 8989:8989 chaptertool-gui
# open http://localhost:8989 in your browser

or use the image from dockerhub:

docker run -p 8989:8989 martintillmann/chaptertool-gui