FFmpeg GUI

使用 Vue.js + ASP.NET + WPF 搭建的 FFmpeg 的 Web/Windows GUI 程序，支持视频转码、拼接等功能

架构

| 项目名 | 项目名（中文） | 介绍 | | ------------------- | ------------------- | ------------------------------------ | | Core | 核心 | 提供Host和WPF、Web的契约以及公共方法 | | Host | 主机 | 通过NamedPipe向WebAPI发布服务 | | Host.Console | 主机（控制台） | 以控制台为入口的Host项目 | | Host.WindowsService | 主机（Windows服务） | 以Windows服务为启动形式的Host项目 | | WebAPI | 服务端 | 使用ASP.NetCore实现的服务器 | | Web | Web客户端 | 使用Vue.js实现的网页端 | | WPF | 桌面GUI | 桌面端的GUI实现 |

截图

网页版

WPF桌面版

v2版本更新计划

2026年2月起，已开始v2版本的开发工作，计划于2026年完成。计划的改造内容包括：

Core

• 更加全面地采用依赖注入方式实现服务的调用
• 新增Postgres等服务型数据库的支持
• 优化整体层次架构

Web项目

• 不再基于Furion框架，改为基于原生ASP.NET Core 10
• 取消Host，改为由WebAPI项目直接调用服务
• 优化接口定义

客户端项目

• 使用Avalonia重构，实现客户端的跨平台

部署/运行

获取程序包

在Github的Release下载最新的包（Web包的地址不能含有子路径），或根据下节进行构建。

部署基于Windows +IIS的Web版本

1. 进入 Generation/Publish/WebPackage
2. 编辑 api的 appsettings.json，主要修改 InputDir和 OutputDir项，指定输入和输出目录。其它修改项详见文件内的注释。
3. 在合适的位置新建一个网站文件夹，将 Generation/Publish/WebPackage内的所有内容复制到新建的文件夹之中。
4. 确保安装了.NET 10 Hosting Bundle，并在Windows中启用了IIS。
5. 在IIS中新建网站，指定物理目录为之前新建的目录。右键其中的api目录，设置为虚拟应用程序。
6. 启动Host。共有两种方式：
   • 运行SimpleFFmpegGUI.Host.Console.exe，将打开一个控制台程序。
   • 在Windows系统中，可以运行CreateWindowsService.bat（将自动申请管理员权限），将Host注册为自启动服务并立即启动。
7. 打开IIS中设置的Url，检查网站运行是否正常。

注意：

• 若输入或输出文件夹位于网络位置等IIS无权限的位置，则需要：
  1. 设置 appsettings.json中的 InputDirAccessable和/或 OutputDirAccessable为 false，告知程序无权限访问，那么后端将通过Host对文件进行访问。
  2. 这种模式下，HTTP上传和下载功能将不可用。

运行Windows客户端版本

双击SimpleFFmpegGUI.WPF.exe运行即可。

构建

准备工作

1. 确保安装了 .NET 10 SDK
2. 确保安装了npm（Node.js）：
3. 确保在根目录下（与ReadMe同级目录）的 bin目录中放置了ffmpeg二进制文件（shared版）：下载 ，具体层级见bin目录内的files.txt。
4. 若要使用媒体信息查询功能，应在根目录（与ReadMe同级目录）下的 bin目录中放置了MediaInfo CLI可执行文件（如MediaInfo.exe）：下载
5. 若要使用编码测试功能，应在根目录（与ReadMe同级目录）下的 bin目录中放置了测试视频 test.mp4和VMAF模型（下载。选取的视频宜为4K分辨率，30秒以上的长度。

bin目录的结构（示例中，ffmpeg目录中的ffmpeg为版本7.1，ffmpeg_FFME目录中的ffmpeg版本为6.1.1）：

bin
│  files.txt
│  MediaInfo.exe
│  test.mp4
│  vmaf_float_v0.6.1.json
│
├─ffmpeg
│      avcodec-61.dll
│      avdevice-61.dll
│      avfilter-10.dll
│      avformat-61.dll
│      avutil-59.dll
│      ffmpeg.exe
│      ffplay.exe
│      ffprobe.exe
│      files.txt
│      postproc-58.dll
│      swresample-5.dll
│      swscale-8.dll
│
└─ffmpeg_FFME
        avcodec-60.dll
        avdevice-60.dll
        avfilter-9.dll
        avformat-60.dll
        avutil-58.dll
        ffmpeg.exe
        ffplay.exe
        ffprobe.exe
        files.txt
        postproc-57.dll
        swresample-4.dll
        swscale-7.dll

配置

配置前端的根网址。分为两种情况：

• 若访问地址含子路径，如：http://域名/ffmpeg，则需要修改两个地方的配置：
  1. SimpleFFmpegGUI.Web\src\net.ts下，修改if (process.env.NODE_ENV === 'production')下一行的API地址，如：return /ffmpeg/api/${controller};
  2. SimpleFFmpegGUI.Web\vue.config.js下，修改module.exports中的publicPath，如publicPath: '/ffmpeg/'
• 若访问地址为IP:端口或域名，如http://域名、http://端口、http://localhost，则不需要进行进一步配置。

自动构建

执行PowerShell：./build.ps1。

参数：

• -w：生成Web（Web、WebAPI、Host）
• -d：生成WPF（标准、单文件、自包含）

若提示无法加载文件 ******.ps1，因为在此系统中禁止执行脚本，需要首先在管理员模式下运行PowerShell并执行 set-executionpolicy remotesigned，然后按Y确认。 生成文件位于 Generation/Publish下，其中 WebPackage为Web部署包，WPF前缀的为Windows桌面客户端。

开发

项目结构

• Core：提供Host和WPF、Web的契约以及公共方法
  • Model：数据库实体和相关非结构化数据模型
  • Dto：用于API与Host交换、前后端交换的数据结构
  • FFMpegArgumentExtension：用于FFMpegCore库上的一些扩展参数
  • Manager：对数据和服务的管理
  • IPipeService：API与Host之间通信的管道契约
  • Logger：日志管理
  • MediaInfoModule：调用MediaInfo.dll
• Host：通过NamedPipe向WebAPI发布服务
  • ConsoleLogger：命令行的Logger
  • FtpManager：FTP相关操作
  • PipeService：对IPipeService的实现，向WebAPI提供服务
• WebAPI：使用ASP.NetCore实现的服务器
  • Controllers：控制器，提供Web接口
  • Converter：使用JSON序列化数据时用到的转换器
  • Dto：与前端交换数据时用到的数据结构
  • PipeClient：用于调用Host发布的服务
  • TokenFilter：在处理请求之前进行拦截，验证是否带有正确的Token
• Web：使用Vue.js实现的网页端
  • public：静态文件
  • src：Web源码，使用WebPack打包
    • assets：静态资源
    • components：Vue组件
    • router：路由设置
    • views：Vue视图
      • Add：新增任务视图
    • common.ts：一些通用方法
    • main.ts：启动文件
    • net.ts：网络相关（Vue.axios）代码
    • parameters.ts：一些固定参数
• WPF：桌面端的GUI实现
  • Model：桌面GUI中用到的一些数据结构
  • Pages：在主界面右侧显示的页面
  • Panels：组成页面或窗口的、具有比较单一的功能的面板
  • ViewModels：所有视图（包括Windows、Panels和Pages）的视图模型
  • MainWindow：主窗口
  • TestWindow：编码性能测试窗口
  • CutWindow：视频裁剪的窗口

注意事项

• libs目录中二进制文件来自于：FzLib和Wpf.Notifications，均已开源。因版本固定，因此直接在libs目录中提供了二进制文件。