Skip to main content

tool for inserting chapter marks in mp3 files

Project description

commandline utility for adding chapter marks to mp3 files similar to mp4chaps utility

many pocast apps on Android and iOS support chapter markers in both mp4 (aac) and mp3 files

this utilizes the excellent eyeD3 tagging module to read and write chapter frames and title subframes


Python 3 (Python 2 is no longer supported)


pip3 install mp3chaps


assuming you have a file named episode_42.mp3, mp3chaps looks for a chapter marks file called episode_42.chapters.txt in the same directory:

00:00:00.000 Introduction
00:02:00.000 Chapter Title
00:42:24.123 Chapter Title

add chapter marks

add (import) chapter marks from text file (unexpected results may occur if chapters already exist, for best results remove chapters first with -r)

mp3chaps -i episode_42.mp3

If you run into errors, try using ASCII. There have been some issue with Unicode.

list chapters

mp3chaps -l episode_42.mp3

remove chapters

mp3chaps -r episode_42.mp3

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mp3chaps-0.4.tar.gz (3.9 kB view hashes)

Uploaded source

Built Distribution

mp3chaps-0.4-py3-none-any.whl (4.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page