jcs.org
command line tool for adding ID3 chapters to an MP3 file
1## mp3chap
2
3A command-line tool for adding ID3 chapters to an MP3 file.
4Most of the grunt work is done by
5[my fork](https://github.com/jcs/id3-go)
6of the `id3-go` Go library.
7
8### Installation
9
10 go get github.com/jcs/mp3chap
11
12This will fetch, compile, and install an `mp3chap` binary as `~/go/bin/mp3chap` (or
13wherever your `$GOPATH` is).
14
15### Usage
16
17 mp3chap file.mp3 0 "chapter 1 is great" 123 "chapter 2 is ok" 456 "chapter 3 is boring"
18
19The first argument is the path to the MP3 file, then pairs of arguments each
20containing a start time in seconds, and the chapter title.
21
22It is assumed that each chapter ends where the next one begins, and that the
23final chapter ends at the last millisecond of the file (as defined in its
24`TLEN` ID3 frame).
25
26If the file does not contain a `TLEN` ID3 frame, a final time argument must
27be supplied (in seconds) which will be used as the end time of the final
28chapter.
29
30 mp3chap file.mp3 0 "chapter 1 is great" 123 "chapter 2 is ok" 456 "chapter 3 is boring" 789
31
32Changes to the ID3 tag in the MP3 file are written out in-place.
33
34### License
35
363-clause BSD