Segment Combiner

Combines multiple segment JSON files into a single unified segments file for video processing.

Use Cases

• Merging segments from multiple detectors
• Consolidating detection results
• Preparing unified input for video-processor

Usage

python3 /root/.claude/skills/segment-combiner/scripts/combine_segments.py \
    --segments /path/to/segments1.json /path/to/segments2.json \
    --output /path/to/all_segments.json

Parameters

• --segments: One or more segment JSON files to combine
• --output: Path to output combined segments JSON

Input Format

Each input file should have a segments array:

{
  "segments": [
    {"start": 0, "end": 120, "duration": 120},
    {"start": 300, "end": 305, "duration": 5}
  ]
}

Output Format

{
  "segments": [
    {"start": 0, "end": 120, "duration": 120},
    {"start": 300, "end": 305, "duration": 5}
  ],
  "total_segments": 2,
  "total_duration_seconds": 125
}

Dependencies

• Python 3.11+

Example

# Combine segments from multiple detectors
python3 /root/.claude/skills/segment-combiner/scripts/combine_segments.py \
    --segments initial_silence.json pauses.json \
    --output all_segments.json

Notes

• Segments are sorted by start time
• Compatible with video-processor --remove-segments input
• All input files must have segments array