# Chaptertool

Chaptertool is a self-hosted web and CLI tool for creators who need to create and convert chapter metadata for podcasts, video, and media files across many formats. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2072/chaptertool

## Description

Chaptertool is a self-hosted web and CLI tool for creators who need to create and convert chapter metadata for podcasts, video, and media files across many formats.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

34/100 (Low), based on 4 of 5 factors.
- Maintained: 43 (last commit 300 days ago)
- Popular: 33 (44 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 15 (2 serious findings, 7 minor, CI)

## Security check

2 serious findings: Uses fast-xml-parser 4.5.3, which has a known critical vulnerability; Uses proxy-addr 2.0.7, which has a known critical vulnerability.
Automated checks on commit a7732f5, 14 Nov 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/martintillmann/chaptertool-gui
- GitHub: https://github.com/Mtillmann/chaptertool
- Official website: https://mtillmann.github.io/chaptertool/
- Unraid: https://ca.unraid.net/apps/chaptertool-1vjas3711pp6rr?q=chaptertool

## Common questions

### How do I make relative chapter image paths display correctly in exported files?

Set an image URL prefix in the export dialog so relative image paths can be resolved.

### Can chaptertool generate chapter images from the media file?

Yes, it can extract video snapshots for Podcasting 2.0 chapters.json from the chapter start or current position.

### What happens if I import a video or existing chapter file while a project is already open?

You can discard the current project and create a new one from the imported file, or keep the current chapters and use the video for screenshots.

### What should I do if the first chapter does not start at 00:00?

Set the first chapter's start time to 00:00.

### Can I adjust the chapter duration when it does not match the media duration?

Yes, expand the duration if it is shorter than the media and reduce it if it is longer.

---
Source: Our Local Host (https://ourlocalhost.com/app/2072/chaptertool), the self-hosted and open-source app directory.
