merge-audio

一个用于合并多个 mp3 音频文件的命令行工具，基于 Node.js 和 ffmpeg 实现。

功能简介

• 支持通过音频文件路径列表批量合并 mp3 文件
• 命令行一键操作，简单高效
• 自动调用 ffmpeg，无需手动安装

安装方法

方式一：本地开发环境

在项目根目录下执行：

npm install
npm link

方式二：全局安装（发布到 npm 后）

npm install -g merge-audio

使用方法

1. 准备音频列表文件

创建一个文本文件（如 audio.txt），每一行写一个 mp3 文件的绝对路径或相对路径，例如：

D:/aforever/joinvideo/audio/1.什么是大模型.mp3
D:/aforever/joinvideo/audio/2.为什么学习大模型.mp3
D:/aforever/joinvideo/audio/3.如何学习大模型.mp3

2. 执行命令合并音频

merge-audio -l audio.txt -o output.mp3

• -l 或 --list：指定音频路径列表文件（必填）
• -o 或 --output：指定输出文件名（可选，默认 output.mp3）

合并完成后，会在当前目录生成合成后的 mp3 文件。

参数说明

| 参数 | 说明 | 是否必填 | 默认值 | |------|------|----------|--------| | -l, --list | 音频路径列表文件 | 是 | 无 | | -o, --output | 输出文件名 | 否 | output.mp3 |

依赖说明

• fluent-ffmpeg
• @ffmpeg-installer/ffmpeg

工具会自动调用内置 ffmpeg，无需手动安装 ffmpeg。

示例

merge-audio -l audio.txt
merge-audio --list audio.txt --output all.mp3

常见问题

• 路径请使用绝对路径或相对于命令执行目录的相对路径
• 确保所有 mp3 文件编码格式一致，避免合并后出现异常

License

ISC