video-aroll-auto-editor（视频滚动自动编辑器）

Video Auto Editor v4.7

A rule-based and AI-powered automated video roughing tool. It automatically identifies the best segments from original footage and performs editing and splicing.

Best for: Single-person / talking-to-camera (A'Roll) content — vlogs, tutorials, podcasts, knowledge-sharing monologues. Not suitable for multi-person dialogues, interviews, or music/B-roll heavy content.

Features

• Scenario A - Single Video: Automatically selects the best segment from one video
• Scenario B - Batch Processing: Processes multiple videos, performs cross-video deduplication, and concatenates into one final video
• Smart Scoring: 4-dimension scoring (clear start/end, fluency, natural rhythm) + fluency analysis
• Content Deduplication: Similarity detection based on transcription text, both within-video and cross-video
• Auto Reports: Generates detailed Markdown reports for each processing run

Best For / Not Suitable

Requirements

• Python 3.8+
• FFmpeg (including ffprobe)
• openai-whisper

Installation

# macOS
brew install ffmpeg
pip install openai-whisper

# Ubuntu / Debian
sudo apt install ffmpeg
pip install openai-whisper

Quick Start

Scenario A: Single Video

Pass a video file path:

python3 video_editor_auto_v4.6.py ./video.MTS ./output

Output:

output/
├── video_粗剪.mp4    # Best segment (clipped)
└── video_报告.md     # Processing report

Scenario B: Batch + Deduplication + Concatenation

Pass a folder path (automatically detected as batch mode):

python3 video_editor_auto_v4.6.py ./Video ./output

Output (only two files, intermediate files are cleaned up):

output/
├── 最终拼接_20260311_1905.mp4  # Deduplicated concatenated video
└── 批量处理报告.md              # Batch report (segment details + dedup decisions)

Command Format

python3 video_editor_auto_v4.6.py <input> [output_dir] [work_dir]

Supported formats: .MTS, .mp4, .mov

Processing Pipeline

Scenario A (Single Video)

Input video → Silence detection → Segment identification → 4-dimension scoring
→ Candidate filtering → Whisper transcription → Fluency analysis
→ Within-video dedup → Layered selection → Clip output

Scenario B (Batch)

Input directory → Process each video (Scenario A, no individual reports)
→ Cross-video deduplication → Concatenate by filename order
→ Clean intermediate files → Generate single batch report

Configuration

All parameters are in the CONFIG dict at the top of the script:

CONFIG = {
    # Silence detection
    "silence_noise": -30,           # dB, lower = stricter
    "silence_duration": 0.8,        # seconds, minimum silence length

    # Filtering
    "min_score": 90,                # Minimum base score (max 100)
    "min_duration": 15,             # Minimum segment duration (seconds)

    # Clip buffer
    "buffer_start": 1,              # Buffer before start (seconds)
    "buffer_end": 3,                # Buffer after end (seconds)

    # Encoding
    "crf": 18,                      # Video quality (18=visually lossless, 23=default)
    "preset": "fast",               # Encoding speed
    "audio_bitrate": "192k",        # Audio bitrate

    # Adjusted score weights
    "penalty_repeat": 5,            # Per repeat penalty
    "penalty_stutter": 3,           # Per stutter penalty
    "penalty_interrupt": 10,        # Sudden interruption penalty
    "bonus_natural_end": 5,         # Natural ending bonus
    "bonus_completeness_max": 3,    # Completeness bonus cap

    # Deduplication
    "duplicate_threshold": 0.7,     # Content similarity threshold (0-1)
}

Tuning Tips

Scoring System

Base Score (4 dimensions × 25 points = 100)

Adjusted Score (0-100)

Applied on top of base score based on transcription analysis:

Layered Selection (Choosing Best Segment)

Not simply the highest score; prioritized filtering:

Layer 1: Prefer naturally ending segments
Layer 2: Sort by fluency (tolerance 1.5 per 30s)
Layer 3: Sort by adjusted score
Layer 4: Tie-break → incomplete: pick last; complete: pick longest

Deduplication Rules

Same selection rule for within-video and cross-video dedup:

Natural end > Adjusted score > Index/filename order (later preferred)

FAQ

Q: No silence segments detected?

Background noise may cause misdetection. Try lowering silence_noise from -30 to -35.

Q: Segments cut too finely?

Silence duration threshold may be too short. Increase silence_duration from 0.8 to 1.0 or 1.5.

Q: Why wasn't the highest-scoring segment chosen?

The system uses layered selection, not raw score comparison. Natural end > Fluency > Adjusted score > Duration. A 95-point segment that ends abruptly may rank lower than a 90-point segment with a natural ending.

Q: Whisper transcription inaccurate?

Default uses small model for speed/accuracy balance. To improve:

• In transcribe_segment, change --model small to --model medium or --model large
• medium model has ~85% accuracy for Chinese; recommended if resources allow

Q: How does cross-video dedup decide which to keep?

Selection rule: Natural end > Adjusted score > Later filename (usually last take, best state).

Q: Where are the detailed reports?

• Scenario A: output/<video_name>_报告.md
• Scenario B: output/批量处理报告.md (includes segment details, transcription summaries, dedup decisions)

- Scenario B does not keep intermediate reports or clips; they are cleaned after concatenation

Project Structure

video_editor_v4.6_release/
├── video_editor_auto_v4.6.py   # Main script
├── README.md                   # This doc
├── CODE_DOCUMENTATION.md       # Technical doc (architecture, modules, API)
├── requirements.txt            # Python dependencies
├── LICENSE                     # GPL v3 license
└── .gitignore                  # Git ignore rules

Technical Documentation

For module implementation details, data structures, algorithms, and extension guides, see CODE_DOCUMENTATION.md.

License

This project is licensed under GPL v3. If you use this software or its derivatives for commercial purposes, you must release your product as open source under the same license (GPL v3 copyleft requirement).

See the LICENSE file for details.

Version: v4.7 | Last Updated: 2026-03-11