Skip to content

StuartCameronCode/VapourBox

Repository files navigation

VapourBox

A user-friendly wrapper for VapourSynth that makes video processing accessible to everyone. Convert between video formats, apply QTGMC deinterlacing, perform IVTC (inverse telecine) for DVD sources, reduce noise, generate subtitles, and fix common video problems — all through a simple drag-and-drop interface.

No scripting required. No command line needed. Just drop your video and go.

VapourBox Screenshot

Use Cases

  • Convert interlaced video to progressive with high-quality QTGMC deinterlacing
  • Recover film from DVDs with IVTC (inverse telecine) — auto-detects 3:2 pulldown
  • Clean up noisy footage with temporal and spatial noise reduction
  • Fix compression artifacts with deblocking and debanding filters
  • Sharpen soft video while preserving detail
  • Generate subtitles from speech using Whisper AI
  • Archive DVDs with proper deinterlacing/IVTC and cleanup
  • Restore VHS captures with specialized filtering pipelines

Download

Get the latest release for your platform:

Download VapourBox

Platform File
macOS (Apple Silicon) VapourBox-x.x.x-macos-arm64.dmg
Windows 10/11 (x64) VapourBox-x.x.x-windows-x64.zip

Installation

macOS

  1. Download the .dmg file from the releases page
  2. Open the DMG and drag VapourBox to your Applications folder
  3. On first launch, VapourBox will automatically download its processing dependencies (~180 MB)

Note: You may need to right-click and choose "Open" the first time, since the app is not notarized.

Windows

  1. Download the .zip file from the releases page
  2. Extract to a folder of your choice (e.g., C:\VapourBox)
  3. Run vapourbox.exe
  4. On first launch, VapourBox will automatically download its processing dependencies (~195 MB)

Features

  • Drag-and-drop interface — drop video files to start, queue multiple files at once
  • Auto-detection — automatically identifies interlaced, telecined, and progressive content
  • Multi-pass restoration pipeline — chain filters in order: deinterlace, denoise, dehalo, deblock, deband, sharpen, color correction, chroma fixes, crop/resize
  • QTGMC deinterlacing — full access to all 70+ parameters, from Draft to Placebo quality
  • IVTC (Inverse Telecine) — recover original 23.976 FPS film from telecined DVD sources
  • Soft telecine handling — strip pulldown flags without re-encoding fields
  • Whisper subtitle generation — generate SRT subtitles from speech, embed into video, or both
  • Real-time preview — side-by-side before/after comparison with live filter updates
  • Zoomable timeline — mouse wheel zoom centered on cursor, drag to pan
  • In/Out point markers — export only a portion of your video
  • Batch queue — process multiple videos with the same settings
  • Preset system — built-in presets (Fast, Balanced, High Quality, VHS Restoration) plus save your own
  • Multiple output formats — H.264, H.265, ProRes, FFV1 lossless, with hardware encoding support (VideoToolbox, NVENC, QSV, AMF)
  • Audio options — passthrough, re-encode (AAC, Opus, FLAC), or strip audio
  • Custom filters — extend VapourBox with your own VapourSynth filters via JSON schemas
  • Aspect ratio preservation — non-square pixel SAR (e.g., anamorphic DVD) carried through the pipeline
  • Standalone — all processing dependencies are bundled and auto-downloaded on first run

Usage

Basic Workflow

  1. Launch VapourBox
  2. Drag and drop one or more video files
  3. Configure restoration passes as needed (or use a preset)
  4. Click Go to start processing

Timeline Navigation

  • Click on thumbnails to jump to that position
  • Drag thumbnails to scrub through video
  • Mouse wheel to zoom in/out (centers on cursor position)
  • Drag when zoomed to pan left/right

In/Out Points

  • Click Set In / Set Out to mark the export range
  • Only frames within the range will be processed
  • Click Clear to remove markers and export the full video

Presets

  • Click the tuning icon in the toolbar to open presets
  • Built-in: Fast, Balanced, High Quality, VHS Restoration
  • Save your current settings for reuse across sessions

Building from Source

See docs/BUILDING.md for build instructions, project structure, and development workflow.

Custom Filters

VapourBox supports user-defined VapourSynth filters via JSON schema files. See docs/FILTER_SCHEMA.md for the full schema reference.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

See the licenses/ directory for full license texts and third-party component attributions.

Author

Stuart Cameron - stuart-cameron.com

Acknowledgments

  • QTGMC by Vit — the deinterlacing algorithm
  • VIVTC by Fredrik Mellbin — VFM field matching and VDecimate for inverse telecine
  • VapourSynth by Fredrik Mellbin — video processing framework
  • havsfunc by HolyWu — QTGMC VapourSynth port
  • whisper.cpp by Georgi Gerganov — speech recognition for subtitle generation
  • FFmpeg project — video encoding
  • Hybrid by Selur — inspiration for this project

Pre-built Binary Sources

macOS ARM64 plugins sourced from:

About

Cross-platform video restoration application using VapourSynth

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors