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.

Files for mp3chaps, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size mp3chaps-0.4.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View
Filename, size mp3chaps-0.4-py3-none-any.whl (4.1 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page