Skip to content

Xpycode/VCR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VCR — Video Corruption Repair

A macOS app that scans video files for corruption, shows exactly what's wrong, and repairs them through intelligent remuxing.

The Problem

Video files — especially MP4s in broadcast environments — get corrupted during recording, transfer, or storage. Identifying what's wrong and fixing it currently requires CLI knowledge (ffmpeg, ffprobe), manual inspection of error logs, and guesswork about the right repair approach.

How It Works

  1. Drop video files onto VCR (or use the Open dialog)
  2. Scan — VCR analyzes each file frame-by-frame, showing progress in real-time
  3. Review — See exactly what's wrong: decode errors, timestamp gaps, truncation, bad headers — with timestamps and severity
  4. Repair — Approve a repair strategy and queue files for processing
  5. Done — Repaired files are output alongside the originals (or to a folder you choose)

Features

  • Dual-engine analysis — AVFoundation for native formats (MP4/MOV), ffmpeg for everything else
  • Frame-by-frame scanning — Detects decode failures, timestamp discontinuities, truncated streams, and header corruption
  • Lossless remux repair — Re-wraps the container without re-encoding (fast, preserves quality)
  • Repair queue — Review scan results, approve strategies, process files sequentially
  • Real-time progress — Per-file progress during both scanning and repair
  • Drag and drop — Drop files or entire folders; VCR finds all supported videos recursively

Tech Stack

  • Swift 6 with strict concurrency
  • SwiftUI + AppKit
  • Bundled ffmpeg/ffprobe (arm64)
  • macOS 14+ (Sonoma)
  • No external dependencies — Apple frameworks only

Building

VCR uses XcodeGen for project generation:

cd 01_Project
xcodegen generate
open VCR.xcodeproj

FFmpeg binaries are bundled via the included script:

./bundle-ffmpeg.sh

Roadmap

  • Scan — frame-by-frame corruption detection
  • Remux repair — lossless container re-wrap
  • Transcode repair — re-encode broken sections
  • Cut repair — remove broken sections with timecode handling
  • Video preview with error markers
  • MXF format support
  • Report export (CSV/JSON)

License

See LICENSE for details.

About

Video Corruption Repair

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors