X.X.X - Work in progress
More appropriate wording in the generated exception when the timestamps are not strictly monotonic.
1.0.0 - 2021-05-18
When printing the chapter list in the terminal, show also the duration of the chapter in minutes and seconds.
When printing the chapter list in the terminal, align the titles of the chapters.
0.6.0 - 2021-04-20
Apparently, many players require that if chapters are present, they must cover all the audio.
So, if the first chapter doesn’t start at “[00:00]” because you don’t specify it in the markdown TOC file or because you are applying a “timestamp offset”, the software will generate a dummy chapter starting at “[00:00]”.
MP3: Chapter timestamps must be encoded as miliseconds, not seconds.
MP4: Audio players require that the last chapter ends at the end of the audio file. If not, the player will keep playing “silence” until the end of the chapter.
MP3: Just in case it is needed for audio players, last chapter ends at the end of the audio file.
0.5.0 - 2021-04-16
MP3: Force a rewrite of the audio file only when the metadata is updated.
MP3: Only clean old chapter information if we are adding new chapter information. Leave metadata alone if the user doesn’t want to change it.
Add “toc2audio” identification in the audio file comment section.
MP4: Preserve metadata of the original file, except the chapter information we are inserting.
Chapter titles: new lines transformed to spaces. Tabs transformed to spaces. Multiple spaces replaced by a single space.
When adding chapters to audio file, print the chapter list on the terminal.
COMPATIBILITY WARNING: Drop HTML tags in chapter titles. Keep only the text.
0.4.0.post1 - 2021-04-14
0.4.0 - 2021-04-14
toc2audiocommand line utility.
--versioncommand line parameter.
New URLs for the project documentation, changelog, etc.
New theme for Sphinx: sphinx_rtd_theme.
0.3.0 - 2021-04-14
--offsetcommand line parameter allows to specify a global offset to add to all timestamps. Useful to specify the duration of the intro you will add to the audio you listened in order to write the show notes markdown document.
Beside showing the TOC in your browser, the HTML is printed in the terminal. You can copy&paste or redirect it to complete your show notes.
A timestamp can be shown as compact format (MM:SS) or not compact format (00:MM:SS).
A timestamp is declared as compact or not compact when read from the markdown TOC document. The idea is to keep the same representation that the user used in the markdown TOC document, after applying the optional time offsets.
0.2.0 - 2021-04-13
0.1.0 - 2021-04-09
Initial release. It can add chapters to MP3 files.