m4s-converter工具全平台官方使用手册
m4s-converter 全平台官方使用手册
1. 工具概述
m4s-converter 是一款专为哔哩哔哩（B站）缓存视频设计的无损转换工具，核心功能是将B站专属加密分片格式
.m4s（视频流、音频流、弹幕文件）快速合并、解码、封装为标准通用的 MP4 视频文件，支持保留/关闭弹幕、自定义输出路径、批量转换、文件覆盖等功能。工具核心依赖GPAC-MP4Box 实现视频音频无损合并封装，全平台适配 Windows、Linux、macOS、Android，支持图形简易模式与命令行高级模式，兼顾新手与进阶用户使用需求。
核心特性：无损转换、批量处理、弹幕自适应、全平台兼容、自定义参数、无水印、不压缩画质音质。
2. 前置依赖与环境说明
2.1 核心依赖
工具运行依赖 MP4Box（GPAC），各平台内置/安装规则不同：
-
Windows / Linux：程序内置 MP4Box 核心，无需手动安装依赖，开箱即用
-
macOS：无内置依赖，必须手动安装 GPAC 工具包
-
Android：可将缓存文件拷贝至电脑端转换
2.2 全平台默认缓存路径
工具默认自动识别B站缓存目录，自定义缓存路径可通过参数手动指定：
-
Windows：
C:\Users\【用户名】\Videos\bilibili\ -
macOS：
~/Movies/bilibili/ -
Linux：
~/Videos/bilibili/ -
Android：
/storage/emulated/0/Android/data/tv.danmaku.bili/download/
3. 全平台安装与部署教程
3.1 Windows 平台（Win10/Win11）
3.1.1 简易图形版（新手推荐）
-
下载对应版本：
m4s-converter-amd64.exe -
将程序放置在非中文、无空格路径文件夹中
-
双击直接运行，程序自动扫描默认B站缓存目录
-
自动识别所有m4s缓存文件，一键批量转换
-
转换完成后，文件默认输出至缓存目录下的
output文件夹
3.1.2 命令行版（进阶使用）
-
按下
Win+R输入cmd打开命令提示符 -
cd 切换至程序所在目录
-
执行基础/高级命令（详见第5章参数说明）
示例基础命令：
m4s-converter-amd64.exe3.2 Linux 平台（Ubuntu/Centos/Debian）
-
下载 Linux 可执行文件：
m4s-converter-linux_amd64 -
赋予运行权限：
chmod +x m4s-converter-linux_amd64 -
基础运行（默认缓存路径转换）：
./m4s-converter-linux_amd64 -
支持所有高级参数命令，无需额外安装依赖
3.3 macOS 平台（Intel/M芯片通用）
3.3.1 安装依赖（必做）
终端执行安装 GPAC：
brew install gpac（未安装brew需先安装Homebrew）3.3.2 部署运行
-
下载 Mac 可执行文件：
m4s-converter-darwin_amd64，ARM的CPU则使用m4s-converter-darwin_arm64 -
赋予运行权限：
chmod +x m4s-converter-darwin_amd64 -
基础运行：
./m4s-converter-darwin_amd64
若提示找不到MP4Box，可通过
-g 参数手动指定GPAC路径。3.4 Android 缓存文件转换方案（核心：电脑端转换）
3.4.1 方案说明
Android设备受系统权限、分区限制，不支持在手机端直接转换。正确流程为：将安卓手机内完整的B站m4s缓存文件夹拷贝至 Windows / Linux / macOS 桌面系统，再使用对应平台的 m4s-converter 工具进行转换，成功率100%，无权限报错。
3.4.2 安卓缓存文件提取步骤
-
安卓手机打开B站，完成视频完整缓存，确保视频无下载中断、无残缺分片；
-
手机连接电脑（开启文件传输/MTP模式），进入安卓B站缓存根目录：
/storage/emulated/0/Android/data/tv.danmaku.bili/download/； -
选中所有视频缓存文件夹（以数字ID命名），整体拷贝至电脑任意无中文、无空格的文件夹内；
-
拷贝完成后断开手机连接，全程在电脑端执行转换操作。
3.4.3 电脑端转换操作（全电脑平台通用）
将安卓拷贝过来的缓存文件夹作为自定义缓存路径，通过
-c 参数指定转换，以下为各平台命令示例：Windows 示例：
m4s-converter-amd64.exe -c "D:\Bili_Cache\download"Linux 示例：
./m4s-converter-linux_amd64 -c ~/Bili_Cache/downloadmacOS 示例：
./m4s-converter-darwin_amd64 -c ~/Bili_Cache/download4. 工作原理
1. 扫描指定/默认B站缓存目录，识别视频m4s、音频m4s、ass弹幕文件；
2. 调用MP4Box无损剥离B站文件加密头，解析原始音视频流；
3. 自动匹配对应视频、音频分片，合并封装为标准MP4；
4. 自动生成ASS弹幕字幕文件（可关闭），同步输出至目标目录；
5. 完成冗余文件清理，保留完整可播放的MP4视频。
5. 完整命令行参数详解（全平台通用）
所有参数全平台通用，支持长短参数混用，可自由组合搭配。
|
短参数
|
长参数
|
参数功能详细说明
|
默认状态
|
|---|---|---|---|
|
-v
|
--version
|
查看工具当前版本号、编译时间、内核信息，执行后直接退出程序
|
非默认，手动调用
|
|
-a
|
--assoff
|
关闭弹幕自动生成功能，转换时不解析、不输出ASS弹幕文件，适合不需要弹幕的场景
|
默认开启弹幕生成
|
|
-o
|
--overlay
|
覆盖输出目录中的同名MP4文件；关闭则自动重命名新文件，避免覆盖旧文件
|
默认不覆盖，自动重命名
|
|
-u
|
--summarize
|
将转换失败、未合并的零散音视频文件统一汇总到单独目录，方便排查异常文件
|
默认不汇总
|
|
-c
|
--cachepath
|
自定义B站缓存扫描路径，适配自定义缓存目录、移动硬盘缓存、多缓存目录场景
|
默认读取系统对应平台默认缓存路径
|
|
-g
|
--gpacpath
|
手动指定MP4Box/GPAC程序绝对路径，仅用于macOS依赖识别失败场景
|
默认自动检索系统环境变量中的MP4Box
|
|
-h
|
--help
|
展示所有参数帮助文档、使用示例，快速查询参数用法
|
非默认，手动调用
|
6. 高频实用命令示例（全平台通用）
例：Windows 则需将
./m4s-converter-xxx 替换为 m4s-converter-amd64.exe6.1 基础默认转换
./m4s-converter-xxx功能：扫描默认缓存目录，批量转换，保留弹幕，不覆盖旧文件，输出至默认output目录
6.2 关闭弹幕转换
./m4s-converter-xxx -a功能：仅转换视频，不生成弹幕文件，输出纯净MP4
6.3 自定义缓存路径
./m4s-converter-xxx -c "自定义缓存绝对路径"示例
./m4s-converter-android -c /storage/emulated/0/Android/data/tv.danmaku.bili/download/6.4 覆盖同名文件
./m4s-converter-xxx -o功能：重复转换时直接覆盖旧MP4文件，无需手动删除
6.5 汇总异常文件
./m4s-converter-xxx -u功能：自动归类转换失败、分片缺失的异常文件，方便排查问题
6.6 手动指定GPAC路径（mac专属）
./m4s-converter-darwin_amd64 -g /usr/local/bin/MP4Box6.7 多参数组合使用（常用全能命令）
./m4s-converter-xxx -a -o -c "自定义缓存路径"功能：关闭弹幕、覆盖旧文件、自定义缓存目录，高效批量转换
7. 输出文件说明
-
MP4视频文件：无损转换成品，画质、音质与原缓存视频一致，支持所有播放器播放
-
ASS弹幕文件：默认同步生成，可在播放器中加载弹幕，搭配视频同步播放
-
异常汇总目录：开启
-u参数后生成，存放转换失败、分片不全的源文件 -
默认输出目录：原缓存目录下
output文件夹，目录不存在则自动创建
8. 常见问题与故障排查
8.1 macOS 提示找不到MP4Box
原因：未安装GPAC或环境变量未生效；解决方案：执行
brew install gpac 重装依赖，或用 -g 参数手动指定程序路径。8.2 Android 扫描不到缓存文件
8.2 安卓拷贝缓存转换失败
原因：缓存文件拷贝不完整、传输中断、文件夹层级错乱、路径含中文/空格；解决方案：重新完整拷贝安卓缓存目录，将文件夹放置在纯英文路径，重新执行转换命令。
8.3 转换后视频无声/黑屏
原因：m4s缓存分片不完整、缓存未下载完毕；解决方案：重新缓存完整视频，删除残缺缓存文件后重新转换。
8.4 Windows 双击无响应
原因：路径含中文/空格、权限不足；解决方案：移动程序至纯英文路径，以管理员身份运行。
8.5 同名文件重复生成
原因：默认不开启覆盖参数；解决方案：执行命令时添加
-o 参数，开启文件覆盖模式。9. 注意事项
-
本工具仅用于个人本地缓存视频备份，禁止用于商用、侵权传播
-
转换前请勿修改缓存目录的默认文件名和文件夹结构，否则会识别失败
-
高清、4K、高帧率视频转换耗时稍长，耐心等待程序执行完毕，勿强制中断
-
所有转换均为无损封装，不会压缩画质、音质，文件大小与原缓存视频基本一致
-
定期清理output输出目录，避免文件堆积占用存储空间
