# magic-cut-video

**Repository Path**: houan/magic-cut-video

## Basic Information

- **Project Name**: magic-cut-video
- **Description**: 视频拼接贴画工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Magic Cut Video (魔法剪辑)

## 简介

Magic Cut Video 是一个基于 Python (Flask) 和 FFmpeg 的开源视频处理工具。它提供了一个直观的 Web 界面，用于管理视频文件夹、随机抽取视频片段进行拼接，并为视频添加个性化的贴纸（贴花/水印）。同时该项目支持打包为 Windows 桌面应用程序。

## 主要特性

*   📂 **文件夹管理**：扫描并管理本地视频文件夹。
*   🎲 **智能拼接**：支持在工作流中随机抽取视频进行组合。
*   🎨 **贴纸编辑器**：可视化的画布编辑器，支持拖拽、缩放、定位贴纸。
*   ⚙️ **工作流控制**：支持多任务并行处理、暂停、取消和进度监控。
*   💻 **桌面应用**：可将 Web 应用打包为独立的 Windows EXE 程序。
*   🎞️ **视频处理**：利用 FFmpeg 进行高效的拼接、分辨率统一和音频处理。

## 环境准备

在运行项目之前，请确保您的环境中包含以下软件：

1.  **Python 3.8+**：建议使用 Python 3.9 或 3.10。
2.  **FFmpeg**：必须添加到系统环境变量 (PATH) 中，或者放置在构建目录下的 `bin` 文件夹中（桌面版）。

## 安装与运行 (Web 版)

1.  **克隆仓库** (如果您还没有代码):
    ```bash
    git clone https://gitee.com/houan/magic-cut-video.git
    cd magic-cut-video
    ```

2.  **安装依赖**:
    ```bash
    pip install -r requirements.txt
    ```

3.  **启动服务**:
    ```bash
    python app.py
    ```

4.  **访问应用**:
    打开浏览器访问 `http://127.0.0.1:5000`。

## 桌面版构建 (Windows)

如果您需要生成独立的桌面版应用程序 (.exe)，请参考详细的构建文档 **[BUILD.md](./BUILD.md)**。

主要步骤包括：
*   安装桌面版依赖：`pip install -r requirements-desktop.txt`
*   准备 `ffmpeg.exe`。
*   执行 `build.bat` 进行打包。

## 项目结构

```text
magic-cut-video/
├── app.py                # Flask 主应用入口，包含 API 接口和调度逻辑
├── desktop.py            # 桌面端启动脚本
├── config.py             # 配置文件
├── video_processor/      # 核心视频处理模块
│   ├── concat.py         # 视频拼接、FFmpeg 命令封装、缓存逻辑
│   └── sticker.py        # 贴纸应用逻辑
├── static/               # 前端静态资源
│   ├── css/              # 样式文件 (style.css)
│   └── js/               # 交互逻辑 (main.js, sticker-editor.js)
├── templates/            # HTML 模板
│   └── index.html        # 主界面
├── BUILD.md              # Windows 桌面版构建指南
└── README-desktop.md     # 桌面版使用说明
```

## 配置与使用

*   **工作流 (Workflow)**：系统支持多工作区切换，方便管理不同的剪辑任务。
*   **输出目录**：在设置中配置生成视频的保存位置。
*   **贴纸池**：上传贴纸后，可以将其拖入“工作流池”或直接在画布上点击放置。
*   **生成进度**：生成过程中可以暂停或取消任务。

## 技术栈

*   **后端**: Python, Flask
*   **视频处理**: FFmpeg, ffprobe
*   **前端**: HTML5, CSS3, JavaScript
*   **桌面打包**: PyInstaller, PyWebView

## 许可证

本项目遵循开源协议，具体信息请查看项目根目录下的 LICENSE 文件。