A command-line tool for adding ID3 chapters to an MP3 file
Go to file
joshua stein 48e01ad8a6 if an odd-numbered arg is supplied, use it instead of TLEN
see #1
2018-04-10 21:38:10 -05:00
README.md if an odd-numbered arg is supplied, use it instead of TLEN 2018-04-10 21:38:10 -05:00
mp3chap.go if an odd-numbered arg is supplied, use it instead of TLEN 2018-04-10 21:38:10 -05:00

README.md

mp3chap

A command-line tool for adding ID3 chapters to an MP3 file. Most of the grunt work is done by my fork of the id3-go Go library.

Installation

go get github.com/jcs/mp3chap

This will fetch, compile, and install an mp3chap binary as ~/go/bin/mp3chap (or wherever your $GOPATH is).

Usage

mp3chap file.mp3 0 "chapter 1 is great" 123 "chapter 2 is ok" 456 "chapter 3 is boring"

The first argument is the path to the MP3 file, then pairs of arguments each containing a start time in seconds, and the chapter title.

It is assumed that each chapter ends where the next one begins, and that the final chapter ends at the last millisecond of the file (as defined in its TLEN ID3 frame).

If the file does not contain a TLEN ID3 frame, a final time argument must be supplied (in seconds) which will be used as the end time of the final chapter.

mp3chap file.mp3 0 "chapter 1 is great" 123 "chapter 2 is ok" 456 "chapter 3 is boring" 789

Changes to the ID3 tag in the MP3 file are written out in-place.

License

3-clause BSD