协调您的音频媒体:转换,规范化,丰富和验证。
harmonizer的Python项目详细描述
和声器
此库帮助您转换、规范化、丰富和验证音乐库。 它完全满足了我们在imr.party的需要,以协调我们的网络广播的音乐库。
该库附带了一个cli工具,允许您处理目录中的音频文件,以创建所有文件的标准化mp3版本,丰富来自不同来源(discogs、spotify)的元数据。
它的功能
- 音频转换:将flac、mp3、aac(m4a)转换为mp3(128k、192k、320k)。
- 音频规范化:峰值规范化输入音频。标准化表示在净空比(0.1意味着最大峰值将我的最大体积的90%)。
- 元数据提取:
- 音频标记:从音频中提取并写入json元数据结果。
- 音频指纹:从音频中提取指纹并写入json元数据结果。
- 元数据扩展:
- covert art extraction(仅限MP3):将covert art提取到图像文件中。
- validation:运行各种完整性检查以断言输入音频符合您在配置中定义的规则。
- 最小输入比特率(仅限MP3)
- 强制性音频标签
- 接受的输入mime类型
输出
所有文件处理将创建2或3个文件:
- 输入音频文件的MP3转换和标准化音频版本。
- 元数据json文件(检查metadata_output.json)
- 封面图片文件(如果存在于原始文件中)
安装
系统依赖性
您的系统上需要有ffmpeg:
苹果操作系统:$ brew install ffmpeg
Linux系统:$ sudo apt install ffmpeg
PIP
$ pip install harmonizer
cli用法
Usage: harmonizer [OPTIONS] AUDIO_INPUT_DIR AUDIO_OUTPUT_DIR Please provide an audio_input_dir path and an audio_output_dir path to launch harmonization of your files. Options: --json-out DIRECTORY Path to directory to which JSON metadata will be written to. --img-out DIRECTORY Path to directory to which extracted cover arts will be written to. -c, --conf FILE Path to your Harmonizer YAML configuration. --help Show this message and exit.
配置文件结构
测试
$ python setup.py test
待办事项:
- 文档字符串
- 更多文档
- 更好的discogs搜索和匹配算法
- 通过配置进行更多管道控制