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桌面版

部署/运行

获取程序包

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

部署基于Windows +IIS的Web版本

1. 进入 Generation/Publish/WebPackage
2. 编辑 api的 appsettings.json，主要修改 InputDir和 OutputDir项，指定输入和输出目录。其它修改项详见文件内的注释。
3. 在合适的位置新建一个网站文件夹，将 Generation/Publish/WebPackage内的所有内容复制到新建的文件夹之中。
4. 确保安装了.NET 8 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 8 SDK （v8.0.403及以上）：
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目录中提供了二进制文件。