keyzf/remoteffmpeggui

使用 Vue.js + ASP.NET 搭建的 FFMpeg 的 Web GUI 平台，支持视频转码、拼接视频、合并音视频等操作。并有使用 WPF 技术的 Windows 桌面端。

FFmpeg GUI

截图

网页版

WPF桌面版

架构

项目名	项目名（中文）	介绍
Core	核心	提供Host和WPF、Web的契约以及公共方法
Host	主机	通过NamedPipe向WebAPI发布服务
WebAPI	服务端	使用ASP.NetCore实现的服务器
Web	Web客户端	使用Vue.js实现的网页端
WPF	桌面GUI	桌面端的GUI实现
WebApp	桌面客户端	对WebAPI、Web和Host进行包装的、使用内置浏览器显示的、基于WinForms的桌面客户端（不再使用）

构建与部署

准备工作

1. 确保安装了 .NET 6 SDK：
2. 确保安装了npm（Node.js）：
3. 确保在根目录下（与ReadMe同级目录）的bin目录中放置了ffmpeg二进制文件（shared版）：下载页面 。测试使用的版本为4.4.1：下载 。共有三个exe文件和8个dll文件。
4. 确保在根目录（与ReadMe同级目录）下的bin目录中放置了MediaInfo.dll：下载页面
5. 确保在根目录（与ReadMe同级目录）下的bin目录中放置了测试视频test.mp4。选取的视频宜使用H.264格式，4K分辨率，20秒以上的长度。

自动构建

执行PowerShell：./build.ps1。

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

部署基于Windows +IIS的Web版本

1. 进入Generation/Publish/WebPackage
2. 编辑api的appsettings.json，主要修改InputDir和OutputDir项，指定输入和输出目录。其它修改项详见文件内的注释。
3. 在合适的位置新建一个网站文件夹，将Generation/Publish/WebPackage内的所有内容复制到新建的文件夹之中。
4. 确保安装了DotNET 6 Hosting Bundle，并在Windows中启用了IIS。
5. 在IIS中新建网站，指定物理目录为之前新建的目录。右键其中的api目录，设置为虚拟应用程序。
6. 运行Host的exe，然后打开设置的url即可使用。

• 若要在IIS中启用自动启动Host功能，还需要：

  1. IIS > 应用程序池。
  2. 为网站选择高级设置。
  3. 将标识（Identity）更改为 LocalSystem。
  4. 重启 IIS。

• 若输入或输出文件夹位于网络位置等IIS无权限的位置，则需要：

  1. 设置appsettings.json中的 InputDirAccessable和/或OutputDirAccessable为false，告知程序无权限访问，那么后端将通过Host对文件进行访问。
  2. 关闭通过WebAPI自动启动Host功能，因为自动启动的Host将继承IIS的权限，依旧无法访问。
  3. 这种模式下，HTTP上传和下载功能将不可用（懒得写）。

• Host启动参数：

  -s           (默认： false) 注册开机启动
  -u           (默认： false) 取消开机启动
  -d           (默认： false) 设置工作目录为程序所在目录
  --help       显示帮助信息
  

开发

项目结构

• 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：组成页面或窗口的、具有比较单一的功能的面板
  • MainWindow：主窗口
  • TestWindow：编码性能测试窗口

注意事项

• Clone仓库后，只需安装好相关SDK，即可进行构建，无需额外设置。
• libs目录中二进制文件来自于：FzLib和Wpf.Notifications，均为开源产品。

已知问题

• 在裁剪视频时，对于部分视频（特别是OBS录制出来的视频），在进入裁剪界面-退出-第二次进入时会崩溃。目前查明的原因是和ModernWpf的XamlControlsResources有冲突，只要新建了该实例，就会崩溃。