toc2audio 1.1.1

安装

$ python3 -m pip install toc2audio

命令行

$ toc2audio --version
0.5.0

$ toc2audio -h
usage: toc2audio.py [-h] [--version] [--offset OFFSET] [--show]
                    [--toc] [--chapters]
                    [TOC] [AUDIO ...]

Add Table of Contents and chapters to audio files

positional arguments:
  TOC              Table of Contents file
  AUDIO            Audio file

optional arguments:
  -h, --help       show this help message and exit
  --version        Show version info
  --offset OFFSET  Seconds or [HH:]MM:SS to add to ALL timestamps
  --show           Show the generated HTML in your browser
  --toc            Store Table of Contents in the audio file
  --chapters       Store chapters details in the audio file

目录格式

目录必须使用Markdown编写。

toc2audio将解析任何Markdown文件，并可选地将生成的HTML和章节元数据插入到您的音频文件中。如果您想使用时间戳（章节），您必须使用以下格式的行

[HH:MM:SS] 章节标题

HH:MM:SS是小时:分钟:秒。小时字段是可选的。您可以指定一位或两位数字的字段。

例如：

This audio was recorded blah blah...

* [00:50] Presentation

    Here I describe the topics we will talk about.

* [02:11] Topic 1

    Blah blah blah blah...

* [17:29] Topic 2

    Blah blah blah blah...

时间偏移

您可以使用--offset命令行参数为TOC markdown文档中的所有时间戳应用全局时间偏移。

支持的音频容器

支持的音频容器有：

• Opus。如果您可以自由选择音频格式，应该选择Opus。它是目前（2021年）通用音频（语音和音乐）的最佳选择，且无专利。它是“自切片面包以来最伟大的发明”。

• Vorbis.

• MP3.

• M4A (MP4音频)。

  通常，MP4有声书有书签的扩展名m4b来表明存在。尽管如此，文件与m4a在位上完全相同。一些软件无法识别m4b文件，所以我使用m4a后缀。

  通常，音频格式将是AAC、HE-AAC或HE-AACv2，但我不太关心。我处理通用的MP4容器，不关注音频数据。我猜我甚至可以向视频数据添加章节。

作者和许可

本软件包的作者是Jesús Cea Avión。

• 电子邮件：jcea@jcea.es。

• 网页：https://www.jcea.es/。

• 博客：https://blog.jcea.es/。

• 推特：@jcea。

• Mercurial仓库.

此代码根据Affero GNU公共许可证v3（AGPLv3）授权。