realies/audiowaveform

Audio Waveform Image Generator Docker容器

镜像概述和主要用途

audiowaveform Docker容器是一个基于C++命令行应用的容器化工具，用于从MP3、WAV、FLAC、Ogg Vorbis或Opus格式的音频文件生成波形数据。波形数据可保存为二进制(.dat)或JSON(.json)格式，并能基于波形数据渲染指定时间偏移和缩放级别的PNG图像，类似于音频编辑软件中的波形可视化效果。该容器支持386、amd64、arm/v6、arm/v7、arm64、ppc64le、s390x架构。

!示例波形

核心功能和特性

• 多音频格式支持：处理MP3、WAV、FLAC、Ogg Vorbis、Opus格式音频文件
• 波形数据生成：输出二进制(.dat)或JSON(.json)格式的波形数据
• PNG图像渲染：基于波形数据生成PNG格式的波形图像，支持指定时间偏移和缩放级别
• 多架构支持：编译支持386、amd64、arm/v6、arm/v7、arm64、ppc64le、s390x架构
• 轻量级容器：提供便捷的命令行使用方式，易于集成到工作流中

使用场景和适用范围

• 音频可视化需求，如音乐平台波形展示
• 音频编辑辅助，预览音频波形特征
• 批量处理音频文件生成波形图像
• 集成到CI/CD流程中自动生成音频波形资源

使用方法和配置说明

Docker CLI使用示例

1. 创建别名（可选）：为简化命令，可创建别名

   bash
   alias awf='docker run --rm -v `pwd`:/tmp -w /tmp realies/audiowaveform'
   

   • --rm：容器退出后自动删除
   • -v pwd:/tmp：将当前目录挂载到容器内的/tmp目录
   • -w /tmp：设置工作目录为/tmp

2. 生成波形图像：使用上述别名处理音频文件

   bash
   awf -i input.wav -o output.png
   

   • -i input.wav：指定输入音频文件路径（相对于当前目录，因挂载了当前目录到/tmp）
   • -o output.png：指定输出PNG图像路径

直接使用命令（不创建别名）

bash
docker run --rm -v $(pwd):/tmp -w /tmp realies/audiowaveform -i input.wav -o output.png

常用参数说明

• -i <input_file>：指定输入音频文件路径
• -o <output_file>：指定输出文件路径（波形数据或图像）
• --format：指定输出波形数据格式（binary或json）
• -s <start_time>：设置波形图像的起始时间（秒）
• -z <zoom>：设置波形图像的缩放级别（像素/秒）