专业视频 / 图片 / 音频处理桌面应用 — 100% AI 生成代码

中文 | English

🤖 本项目 100% 由 AI 生成

📸 软件预览

🎬 主界面	📋 使用演示

FFmpeg++ 是一款基于 Flutter（Material Design 3 前端）+ C++17（共享库后端，通过 FFI 加载）的跨平台桌面视频/图片/音频处理工具。核心功能为蓝图式节点编辑器，支持构建复杂的多步骤处理流程。

支持 Windows、Linux（x64 / ARM64）、macOS（Universal）三大平台。

┌──────────────────────────────────┐
│   Flutter 桌面 GUI (Dart)        │  ← Material Design 3
│   Dart FFI ↔ libffmpegpp         │
├──────────────────────────────────┤
│   C++17 后端 (dll/so/dylib)      │  ← 共享库模式（FFI 轮询）
│   subprocess → ffmpeg / ffprobe  │
├──────────────────────────────────┤
│   FFmpeg / FFprobe               │  ← 外部依赖（用户自行安装）
└──────────────────────────────────┘

节点编辑器是 FFmpeg++ 的核心。详见 NODE_EDITOR.md。

• 无限画布，支持平移缩放
• 拖拽节点，自由连线
• 右键添加节点 / 删除连线
• 25+ 节点类型覆盖视频、音频、图片处理
• 自动验证（环路检测、类型冲突、时长约束）
• 智能合并：音视频处理 + 字幕 = 单条 ffmpeg 命令
• 逻辑块：循环处理支持
• 调试覆盖层显示执行计划
• 多源文件节点 = 多个独立任务

确保已安装 FFmpeg 并加入 PATH 环境变量。

• Flutter SDK 3.44+
• CMake 3.20+
• FFmpeg 在 PATH 中
• Windows: Visual Studio 2022/2025，含 C++ 桌面开发工作负载；Inno Setup 6+
• Linux: cmake g++ libgtk-3-dev pkg-config ninja-build
• macOS: Xcode Command Line Tools

# 1. 编译 C++ 后端
cd server_cpp
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)    # Linux/macOS
# Windows: cmake --build . --config Release

# 2. 启动 Flutter GUI
cd ../../ffmpegpp_gui
flutter pub get
flutter run -d linux   # 或 -d windows / -d macos

移动端适配只影响 Android 平台，桌面端行为不变：

• 底部液态玻璃导航栏：PC 左侧边栏在移动端移至底部，选中项为可拖动 胶囊遮罩（水平拖动 → 松手吸附最近项并跳转，逻辑与 PC 侧边栏一致）。
• 命令 / 日志移入设置：底部栏只保留 项目 / 处理队列 / 配置库 / 设置， 命令与日志在 设置 → 工具 中进入。
• Monet 动态取色：Android 8.1+ 跟随系统壁纸生成 Material You 配色 （设置 → 外观 → 动态取色 可关闭），参考 Android 16 莫奈风格。
• 内置 FFmpeg：ffmpeg / ffprobe 以 arm64 静态可执行文件打包进 APK （jniLibs），C++ 后端通过子进程调用，无需用户安装任何东西。
• 触屏适配：项目页禁用桌面拖放、节点编辑器顶部返回栏、状态栏/手势 区安全边距等。

构建 APK（需 Android SDK + NDK r26d + JDK 17+）：

# 一键构建全部（桌面端 + Android APK）
build/build_all.sh all

# 只构建 Android APK（自动修补 file_picker compileSdk、自动重试防 OOM）
build/build_all.sh android

# 分步：先交叉编译内置 ffmpeg/ffprobe + C++ 后端（产物在缓存根 dist/）
build/android/build_ffmpeg.sh
# 再构建 APK
build/android/build_apk.sh

# 产物: ffmpegpp_gui/build/app/outputs/flutter-apk/app-release.apk (arm64-v8a)

构建脚本集中在 build/（详见 build/README.md）：代码在仓库、缓存/工具链在 sdb2，路径均可通过 FFMPEGPP_CACHE/FFMPEGPP_ROOT 等环境变量覆盖。

说明：桌面端更新机制/安装器不适用于移动端，设置页已做对应隐藏与提示； GPU 硬编码器（NVIDIA/AMD/Intel）在 Android 上不可用，自动回退 CPU 编码。

MIT License — 详见 LICENSE

🎬 Main	📋 Demo

FFmpeg++ is a cross-platform desktop tool for video, image, and audio processing. Built with Flutter (Material Design 3 frontend) and C++17 (shared library backend via FFI), featuring a blueprint-style node editor with 25+ node types for complex processing workflows.

Supports Windows, Linux (x64 / ARM64), and macOS (Universal).

┌──────────────────────────────────┐
│   Flutter Desktop GUI (Dart)     │  ← Material Design 3
│   Dart FFI ↔ libffmpegpp         │
├──────────────────────────────────┤
│   C++17 Backend (dll/so/dylib)   │  ← Shared lib (FFI poll)
│   subprocess → ffmpeg / ffprobe  │
├──────────────────────────────────┤
│   FFmpeg / FFprobe               │  ← External dependency
└──────────────────────────────────┘

The node editor is the core of FFmpeg++. See NODE_EDITOR.md for full documentation.

• Infinite canvas with pan & zoom
• Drag-and-drop nodes, freeform connections
• Right-click to add nodes, right-click connections to delete
• 25+ node types covering video, audio, and image processing
• Automatic validation (cycle detection, type conflicts, duration constraints)
• Smart merge: AV processing + subtitle burn = single ffmpeg command
• Logic blocks: loop processing support
• Debug overlay showing execution plan
• Multiple source nodes = multiple independent tasks

Make sure FFmpeg is installed and in your PATH.

• Flutter SDK 3.44+
• CMake 3.20+
• FFmpeg in PATH
• Windows: Visual Studio 2022/2025 with C++ Desktop workload; Inno Setup 6+
• Linux: cmake g++ libgtk-3-dev pkg-config ninja-build
• macOS: Xcode Command Line Tools

# 1. Build C++ backend
cd server_cpp
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)    # Linux/macOS
# Windows: cmake --build . --config Release

# 2. Run Flutter GUI
cd ../../ffmpegpp_gui
flutter pub get
flutter run -d linux   # or -d windows / -d macos