dskrad / mp3chaps

add chapter marks to mp3 files (use cases: audiobooks, podcast episodes, etc)
MIT License
80 stars 17 forks source link

mp3chaps

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 <https://github.com/nicfit/eyeD3>_ tagging module to read and write chapter frames and title subframes

requirements

Python 3 (Python 2 is no longer supported)

installation

pip3 install mp3chaps

usage

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