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, extract DVD titles, 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
  • Process DVDs directly from disc — select titles, extract, deinterlace, and encode in one step
  • Import VIDEO_TS folders from previously ripped DVDs
  • Batch-import folders of video files
  • 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, folders, or VIDEO_TS directories to start
  • Auto-detection — automatically identifies interlaced, telecined, and progressive content
  • Multi-pass video processing 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
  • DVD disc import — open a DVD, pick a title, extract and process directly
  • Batch queue — process multiple videos with the same settings
  • Preset system — built-in presets (Fast, Balanced, High Quality, VHS Cleanup) 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 (or a folder, or a DVD VIDEO_TS folder)
  3. Configure processing passes as needed (or use a preset)
  4. Click Go to start processing

DVD Import

VapourBox can extract and process titles directly from DVD discs or from previously copied VIDEO_TS folders.

From a physical disc:

  1. Insert a DVD
  2. Click the disc icon in the toolbar (or use the Open DVD button on the drop zone)
  3. VapourBox reads the disc structure and shows a title picker with duration, resolution, chapters, and audio tracks
  4. Select a title and click Add to Queue
  5. The title is extracted to a temporary file, then analyzed and queued like any other video
  6. Configure your processing passes and click Go

From a DVD folder:

  • Drag and drop a folder containing a VIDEO_TS directory (or the VIDEO_TS folder itself)
  • VapourBox detects it as a DVD and shows the title picker automatically

From a folder of video files:

  • Drag and drop any folder, or click Open Folder on the drop zone
  • VapourBox recursively scans for video files and adds them all to the queue

CSS Decryption (libdvdcss)

Most commercial DVDs use CSS (Content Scramble System) encryption. VapourBox uses libdvdread for DVD access, which can load libdvdcss at runtime for decryption. libdvdcss is not bundled with VapourBox — if you need to read encrypted discs, install it separately.

Note: CSS decryption may have legal restrictions in some jurisdictions. VapourBox does not officially endorse or support CSS decryption. libdvdcss is a third-party library that is loaded automatically by libdvdread if present on your system.

macOS (via Homebrew):

brew install libdvdcss

Windows:

Download libdvdcss-2.dll from VideoLAN and place it in the VapourBox application directory (next to vapourbox.exe).

Unencrypted DVDs (home recordings, some independent releases) work without libdvdcss.

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 Cleanup
  • 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
  • libdvdread by VideoLAN — DVD reading and navigation
  • 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