Video-Toolbox

繁體中文

A lightweight yet powerful FFmpeg automation tool for batch video processing. Supports Windows, macOS, and Linux with an easy-to-use bilingual CLI.

---

Features

AI & Classic Frame Interpolation

• AI Interpolation (RIFE)

  • High Quality: Uses Real-Time Intermediate Flow Estimation (NCNN/Vulkan) for superior smoothness.
  • Automatic Setup: The tool automatically detects, downloads, and configures the RIFE models (~50MB) on the first run—no manual installation required.
  • Hardware Acceleration: Utilizes Vulkan for GPU-accelerated inference.
  • Output: Doubles the source frame rate (e.g., 30fps → 60fps).

• Classic Interpolation

  • Uses FFmpeg's minterpolate filter (CPU-based).
  • Target FPS options: 24 fps (cinematic), 30 fps (standard), 60 fps (smooth).

• RIFE ncnn Vulkan (Auto-managed and downloaded by the application)

Video Conversion & Transcoding

• MP4 (H.264) - Universal compatibility
• MP4 (H.265/HEVC) - High compression ratio, smaller file size
• MP4 (AV1) - Next-generation codec, excellent quality (GPU requires RTX 40+)
• MKV - Lossless stream copy
• MOV - Apple ProRes/H.264 compatible
• GIF - High-quality animated image output

Audio Extraction

• Extract audio tracks to MP3 format with high quality (VBR Q2)

Hardware Acceleration

• CPU Mode: High quality, maximum compatibility
• GPU Mode: NVIDIA NVENC hardware encoding for ultra-fast processing

Bilingual Interface

• English and Traditional Chinese (繁體中文) support
• Language selection at startup

---

Requirements

• Python 3.10+
• FFmpeg (auto-managed via imageio-ffmpeg or system installation)
• NVIDIA GPU (optional, for hardware acceleration)

---

Quick Start

Windows

# Double-click or run in terminal
start.bat

macOS / Linux

chmod +x start.sh
./start.sh

The launcher will automatically:

1. Create a Python virtual environment (venv/)
2. Install required dependencies
3. Start the application with your selected language

---

Usage

Workflow

1. Select Language - Choose between English or Traditional Chinese.
2. Enter Input Path - Drag and drop a file or folder into the window (supports batch processing).
3. Enter Output Path - Specify a destination folder, or simply press Enter to use the default output folder.
4. Choose Function - Choose Frame Interpolation, Conversion, or Audio Extraction.
5. Select Hardware - Choose CPU mode or GPU acceleration (NVIDIA NVENC).
6. Configure Options - Set target FPS, output format, etc.
7. Confirm & Execute - Review your settings and start the process.
8. View Report - Check the summary and success/failure statistics.

---

Supported Video Formats

Input Formats	Output Formats
MP4, MKV, AVI, MOV, FLV, WMV, TS, WebM, M4V	MP4, MKV, MOV, GIF, MP3

---

Advanced Configuration

GPU Encoding Presets

Codec	NVENC Encoder	Preset	Notes
H.264	h264_nvenc	P4	Quality/Speed balance
H.265	hevc_nvenc	P4	High compression
AV1	av1_nvenc	P4	RTX 40 series only

---

License

MIT License - Feel free to use, modify, and distribute.

---

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.