一个多媒体转码百宝箱 / 一个 FFmpeg 的套壳
-
原汁原味的 FFmpeg 工作流
全链路支持：输入 → 滤镜 → 编码 → 输出。参数配置透明直观，对齐 FFmpeg 的原生用法。 -
所见即所得的参数生成
所有 FFmpeg 参数公开透明，用户通过操作界面，即能同时学习 FFmpeg 的命令。 -
自动适配本机 FFmpeg 功能
自动扫描并加载本机 FFmpeg 支持的全部复用器、解复用器、滤镜、编码器及其参数，尽支持尽支持。 -
预置选项 & 专业扩展
内置数十款常见编码器、封装格式、分辨率等参数的最佳实践与简要说明，从傻瓜式自动到高级参数随心切换。 -
高级滤镜图、多输入多输出支持
相比大多数软件仅支持的简单滤镜，FFBox 支持完整的流图和滤镜图编辑，可处理复杂的多输入多输出任务。 支持扫描 FFmpeg 官网滤镜文档供用户随时参考。 -
舒适界面与自研组件库
自研 UI 组件库，界面细节考究，针对浅色/深色模式细致调节界面细节，视觉体验焕然一新。 -
改进的的进度与性能面板
图形化实时显示进度、速度、码率、剩余时间等信息，并支持以图表模式直观展示。 -
前后端分离、可部署、跨平台
既可直接使用 FFBox，也可单独使用 Node.js 远程转码服务 + WebUI 部署，或混搭使用。 完整支持 Windows、Linux、macOS。支持在 Android 上部署服务。 -
任务管理系统
支持拖入即开始、完成即移除。 支持单任务/全任务的启动、暂停、复制操作。 支持自定义并发数。 支持崩溃后保留未完成任务项。 -
更多实用功能
保留文件时间戳或依条件改写时间戳。 自研开发/打包脚本，一键傻瓜式打包。 Windows 专属支持：特制安装器、DirectX 开屏画面、任务暂停功能。 -
独创特色
全球独一无二的使用许可与条款！ 全球独一无二的「涩话草坪」！
详细软件介绍请访问 FFBox 官网。
您现在看到的是 5.x 版本的 readme 文件。FFBox 在不同的大版本之间，使用的技术/框架存在区别。若需查阅版本对应的 readme，建议切换到对应分支。
1.x 版本：经典的“html + css + js”前端三件套，没有工程化和模块化。2.x 版本：使用 vue 2 进行工程化、模块化开发。主要控制逻辑集中在状态管理器上。3.x 版本：更好的高聚低耦与工程结构，服务与 UI 分离，引入 TypeScript，支持远程控制。4.x 版本：全新界面，使用更新、更多样的技术架构，自行编写开发与打包脚本，彻底分离前后端。5.x 版本：技术和框架上与 4.x 版本大体上无异，主要在功能上改进了与 ffmpeg 的“全”适配程度。
由于这里不是前端课堂，此处当然不会有手把手的详细指南🌚。以下会列出一些需要的东西，您可自行了解：
编辑器：推荐使用Visual Studio Code，已在.vscode目录中预置了启动调试后端、插入调试主进程等相关任务。运行环境：推荐使用node.js，主要用于项目的编译。如有需要还可nvm，使用它可以切换当前的 nodejs 版本，解决部分情况下运行不起来的问题。
如有需要，也可使用bun作为运行环境。您可以把它理解成安卓版鸿蒙。但目前 bun 无法用于调试。包管理器：推荐使用pnpm。由于 electron-builder 对 utimes 的编译存在问题，pnpm 已配置为node-linker=hoisted。
您也可以使用npm作为包管理器，npm 的速度约慢一半。这样打出来的包体积大小会有轻微不同（哪怕删除 lock 文件拉取最新）。
yarn和bun打出来的包目前只有前端可以交由 electron-builder 打包，后端 pkg 打出来的包不可用。404 和 408 问题：pnpm install、pkg:backend、package的时候均需要联网下载二进制预编译文件。GitHub 的 url 在国内尤为难以访问，您可能需要依据互联网上的攻略，通过如pnpm set registrypnpm set ELECTRON_MIRROR等方式配置源或者“转发的魔法”。Windows 上的 FFBoxHelper：该文件已预编译好。如果您想自行编译，则需要Visual Studio 2022。Windows 上的安装包：Linux / macOS 的完整打包流程无需额外配置软件，但 Windows 上需要安装Inno Setup 6，并将软件（iscc.exe）放置在环境变量中。另外，ChineseSimplified.isl也需要另行准备放在该软件目录下。
本项目并不自带 FFmpeg。如果您没有 FFmpeg，那么 FFBox 只能为您展示启动命令，不能进行转码工作。您需要在 FFmpeg 下载页面 下载 FFmpeg 后，根据 FFBox 的指示，将其放入系统路径（推荐）或程序目录中。
flowchart TB
subgraph DFmjs[dev-frontend.mjs]
IPE1[injectProcessEnv] --> CSR["createServer(renderer)"] --> watchPreload --> watchMain
end
subgraph BBmjs[build-backend.mjs]
IPE2[injectProcessEnv] --> BB1["buildBackend"]
end
subgraph BBmjs2[build-backend.mjs]
IPE3[injectProcessEnv] --> BB2["buildBackend"]
end
subgraph BFmjs[build-frontend.mjs]
IPE4[injectProcessEnv] --> buildMain --> buildPreload --> buildRenderer
end
subgraph VCLaunchB["vscode launch 编译调试后端 (vite)"]
VSTask["vscode task 启动"] --> BBmjs2
end
subgraph 生产前端["生产前端【npm run build:frontend】"]
BFmjs
end
subgraph 生产后端["生产后端【npm run build:backend】"]
BBmjs --> PB[pkg:backend]
end
subgraph 开发前端["开发前端【npm run dev:frontend】"]
DFmjs
end
subgraph 开发后端["开发后端【vscode F5】"]
VCLaunchB
end
注1[注意 Windows Helper 需要使用 VS 手动编译并放入项目根目录]
开发("开发") --> 开发后端 --> 开发前端
打包("打包") --> 生产后端 & 生产前端 --> pkg["npm run package"]
注1 --> 开发 & 打包[打包【npm run build:everything】]