Vapoursynth Plugin for EDIUS 11


Introduction

The VapourSynth Importer is a high-performance EDIUS plugin that bridges the gap between professional video processing and the EDIUS timeline. By wrapping the powerful VapourSynth engine into an EDIUS-compatible importer, users can apply advanced filters, AI upscaling, and complex audio processing directly to their clips.

Unlike standard importers, this plugin uses a "Script-as-UI" approach, allowing users to define complex processing pipelines in a simple Python script that automatically generates a user interface.

The "Script-to-GUI" Concept

The core innovation of this plugin is its ability to read a single .vpy file and transform it into a functional GUI within EDIUS. You don't need to write complex C++ code to add new features; you simply define your filters in Python, and the plugin builds the buttons, sliders, and checkboxes for you.

Key Features

Advanced Video

Access to industry-standard filters like QTGMC (Deinterlacing), ESRGAN (AI Upscaling), and advanced stabilization via MVTools.

Full Audio Support

Apply audio gain, normalization, or complex audio processing alongside video, ensuring perfect synchronization.

Auto-Module Management

Missing a VapourSynth plugin? The plugin detects missing modules and offers to download/install them via the BAT Server.

Dynamic GUI

Every parameter in your script (sliders, dropdowns, checkboxes) is automatically rendered as a UI element in EDIUS.

Configuration Guide

A .vpy file is divided into three main sections: INPUT, EFFECTS, and OUTPUT.

1. INPUT Configuration

Defines the source file and how it is loaded into the pipeline.

INPUT = {
    "source": "C:/path/to/video.mp4",
    "_label_source_path": "Source File Path",
    "_type_source_path": "file_picker",
    "_type_source_import": ['Auto', ['Auto', 'No file index', 'Use file index']],
}

2. EFFECTS Configuration

The heart of the plugin. A list of filters applied in order. You can use Internal Presets or Dynamic Functions.

EFFECTS = [
    {
        "_label": "Audio Gain",
        "cfg": { "Audiogain (dB)": [0.0, [-24, 12]] },
        "internal_preset": "audio_gain_filter",
        "_enabled": False,
    },
    {
        "_label": "Deinterlace",
        "cfg": { "Preset": ['Medium', ['Slower', 'Slow', 'Medium', 'Fast', 'Faster']] },
        "namespace": "havsfunc",
        "function": "QTGMC",
        "_enabled": True,
    }
]

3. OUTPUT Configuration

Defines the final pixel format and color space for the EDIUS import.

OUTPUT = {
    "_label_pixel_format": "Output Pixel Format",
    "_type_pixelFormat": "enum_combo",
    "pixel_format": "YUV422P8",
}

Syntax Reference

Use these special keys to control the UI and behavior:

Key Description
_label The name displayed in the EDIUS UI.
_description Tooltip text for the UI element.
_enabled Set to True to show/activate the filter.
cfg Dictionary of parameters (sliders, lists, etc.).
namespace The Python module (e.g., std, havsfunc).
function The specific function within that module.

Technical Details

  • Engine: VapourSynth (Python-based)
  • Integration: EDIUS Importer Plugin (C++)
  • Supported Formats: YUV422P8, YUV422P10, RGB24, RGB30, RGB48
  • Audio: PCM/WAV via VapourSynth Audio Source
  • Module Management: Integrated with BAT Server for seamless dependency installation.

© 2024 VapourSynth Importer for EDIUS. All rights reserved.