Welcome to Doom9's Forum, THE in-place to be for everyone interested in DVD conversion.

Before you start posting please read the forum rules. By posting to this forum you agree to abide by the rules.


Go Back   Doom9's Forum > Capturing and Editing Video > VapourSynth

Thread Tools Search this Thread Display Modes
Prev Previous Post   Next Post Next
Old 16th April 2020, 13:30   #1  |  Link
Registered User
Join Date: Mar 2020
Posts: 101
VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS

This VapourSynth + Plugins + Scripts + Hybrid [2020.10.10] DMG package includes:

VapourSynth-R52 Installer
Downloaded from https://forum.doom9.org/showthread.php?t=175522
VapourSynth Plugins for Hybrid
Downloaded from https://forum.doom9.org/showthread.php?t=175522
Hybrid UI 2020.09.15 (including internal components updates 2020.10.10)
Downloaded from https://forum.selur.net/showthread.php?tid=1495
XQuartz 2.7.11 (Required by Hybrid to read image sequences)
Downloaded from https://www.xquartz.org/
D2V Witch v4 (Required by Hybrid to process VOB files and DVDs)
Downloaded from https://forum.doom9.org/showthread.php?t=175522
VulkanSDK (Required by Waifu2x nvk resizer filter)
Downloaded from https://vulkan.lunarg.com/sdk/home
JESExtensifier 3.0.5 (It helps to change aspect ratio and other metadata tags inside MOV container)
Downloaded from https://www.dropbox.com/sh/x8o2q07zy...-Wj_Ome8a?dl=0
You can also use instead AMCDXVideoPatcher http://mogurenko.com/ or BBC QTFF Parameter Editor command line tool https://github.com/bbc/qtff-parameter-editor

DOWNLOAD package from Google Drive: https://drive.google.com/drive/folde...D6?usp=sharing

Quick FAQ for Beginners:

VapourSynth http://www.vapoursynth.com/ is a cross-platform Open Source application for video manipulation with command line interface. It also can be used as a plugin inside other video editing apps, video players and UI wrappers. It require Python https://www.python.org/ environment to work. VapourSynth support external Plugins http://vsdb.top/ (.dylib extension on macOS). Some plugins may require additional Dependencies Libraries (also .dylib extension on macOS). It also may require external Script files (.py extension) to automate some processes.
Current version of VapourSynth (including Python, Plugins, Dependencies Libraries and Scripts) is wrapped inside single Framework container. On macOS it is installed to:
Dependencies Libraries installed to:
External Plugins installed to:
Scripts installed to:
Some legacy apps may read Dependencies Libraries and Pugins from legacy location:
To fix legacy incompatibility problems VapourSynth installs to that directory special alias links from "libvapoursynth-script.dylib" and "libvapoursynth.dylib" files.

QTGMC http://avisynth.nl/index.php/QTGMC is a series of scripts for VapourSynth that combine chain of different plugins and produce Motion Compensation deinterlace with double frame rate and amazing artifacts-free quality.

Hybrid http://www.selur.de/ is a cross-platform UI wrapper for VapourSynth filters, scripts https://github.com/Selur/VapoursynthScriptsInHybrid and a bunch of other video tools http://www.selur.de/licence It use well known FFmpeg library https://evermeet.cx/ffmpeg/ to read and write ProRes MOV files as well as many other codecs and file types. Scripts, FFmpeg, x264, MKVToolNix and some other important components located inside Hybrid.app can be easily updated manually.
Hybrid combines a lot of video tools inside but it don't contains pre-installed VapourSynth. To make QTGMC work you need to install and adjust VapourSynth with all required plugins and scripts separately.

Prepare to Installation FAQ:

Hybrid 2020 contains a lot of fundamental internal changes. To avoid preferences conflict you need COMPLETELY UNINSTALL LEGACY HYBRID 2018 VERSION, DON'T LAUNCH THAT LEGACY VERSION ANYMORE and DON'T IMPORT ANY SAVED LEGACY PRESETS TO NEW VERSION:
1. Make screenshots of pages with important Hybrid settings.
2. Delete Hybrid.app from "Applications" folder.
3. Delete folder ~/Library/Application Support/Hybrid
4. Delete file ~/Library/Preferences/de.selur.Hybrid.plist

Do NOT install VapourSynth with Homebrew https://brew.sh/ because it use legacy installation paths.
Do NOT mix this installer with other VapourSynth versions or with different installers made by other people.
If you used any other VapourSynth installations before - delete old versions before install this one.

Disable SIP (System Integrity Protection):
Restart computer
Hold down "Command + R" to reboot into Recovery Mode
Click Utilities, select Terminal and type:
csrutil disable
Press "Enter" on keyboard and restart computer

Allow install apps from unidentified developers by typing in Terminal:
sudo spctl --master-disable
Press "Enter" on keyboard.
Type your password.
Press "Enter" on keyboard.

Disable Gatekeeper turning back on automatically after 30 days by typing in Terminal:
sudo defaults write /Library/Preferences/com.apple.security GKAutoRearm -bool NO
Press "Enter" on keyboard.
Type your password.
Press "Enter" on keyboard.

Disable quarantine for downloaded apps by typing in Terminal:
sudo defaults write com.apple.LaunchServices LSQuarantine -bool NO
Press "Enter" on keyboard.
Type your password.
Press "Enter" on keyboard.

For more details see additional FAQs:

I personally recommend to use 10.14.6 Mojave and don't see any practical reason move to macOS 10.15 Catalina with insane security restrictions and without 32-bit apps support.

Installation FAQ:

1. Open "VapourSynth+Plugins+Scripts+Hybrid-2020.10.10.dmg"
2. Install "VapourSynth-R52.pkg"
3. Install "Hybrid 2020.09.15 and Plugins.pkg"
4. Install "XQuartz.pkg"
5. Install Vulkan:
Open "vulkansdk-macos-"
Open Terminal & browse with the following command:
cd /Volumes/vulkansdk-macos-
Run the following command to install:
sudo ./install_vulkan.py
6. It is also possible (and highly recommended) to use native system buttons with text names instead of custom UI icons and also adjust UI font size:
Show invisible files and folders by pressing "Command + Shift + ."

Create invisible folder ".hybrid" in home directory ~/.hybrid/
Put "misc.ini" file included in DMG package inside that ".hybrid" folder

See more customization options here https://forum.selur.net/showthread.php?tid=10.
Note that Hybrid 2020.09.15 is the last version that allow to resize window and disable custom icons.

VapourSynth installer creates "VapourSynth" folder on your Desktop with quick alias links to Plugins, Dependencies, Scripts and Uninstall script. You can move this folder to any location, or just delete it.

When you open "Hybrid 2020.09.15 and Plugins.pkg" or "Hybrid.app" first time, it may give you a message: "can’t be opened because the identity of the developer cannot be confirmed."

To fix this problem mouse right-click on "Hybrid 2020.09.15 and Plugins.pkg" or "Hybrid.app", select in menu "Open", and next press "Open" button in pop-up window.

Usage FAQ:

Open File
Set Output Folder
Render file (Command-F1 keyboard shortcut)
Base -> Video: ProRes
Base -> Audio: passthrough all
Base -> Default container: mov
Base -> Generate
ProRes -> Profile: ProRes 422 HQ
Filtering -> (De-)Interlace/Telecine -> Click on "Auto" checkbox to enable deinterlace.
Filtering -> (De-)Interlace/Telecine -> Deinterlacer: QTGMC (VapourSynth)
Filtering -> (De-)Interlace/Telecine -> Overwrite input scan type to: (For Hi8 tape sources set it to "Top Field List", For DV tape sources set it to "Bottom Field List". If rendered video plays back with with "jumping/strobing" frames effect, change Field List order setting)
Filtering -> (De-)Interlace/Telecine -> Preset: Slow (in "Custom mode" you can also experiment with other settings)
Filtering -> (De-)Interlace/Telecine -> Bob (use for double frame rate deinterlace mode)
Filtering -> VapourSynth -> Color -> ColorMatrix: From Rec.601/470bg/470m To BT.709 (apply only If you upscale SD to HD with Crop/Resize tools in Hybrid)
Filtering -> VapourSynth -> Line -> Resizer -> NNEDI3
Neural network resizer NNEDI3. It removes jaggies upscale artifacts on contrast diagonal lines, but don't adds artificial oversharpening. Recommended settings for CPU: Neurons 32 (64 max), Network 2. NNEDI3 use its own internal resize algorithm and don't depends of resize algorithm selected in "Crop/Resize" tab.

Some Tips to Speedup Workflow:

Turn on GPU and OpenCL support in plug-ins when possible and select "Device: -1" (autodetection). Depending of hardware it will give you 2x to 5x speed increase.
Instead of "Open File" dialog it is possible to drag and drop file directly to path field.
For batch processing you can select multiple files in "Open File" dialog or drag and drop multiple files directly to path field.

Config -> Filenames -> Suffix:
Config -> Paths -> Default input path:
Config -> Paths -> Default temp path:
Config -> Paths -> Adjust: Output path to source path
Config -> Profiles -> Auto save defaults (this allow to remember all program settings on next launch)
Config -> Internals -> FFmpeg/MEncoder threads: (set it according to your CPU)
Config -> View -> Uncheck "Show tooltip sidebar" (you can just mouse right-click on any text name to show tooltip)
Jobs -> Misc -> Delete jobs when finished

Bugs and Fixes in Hybrid 2020.09.15:

Problem: Hybrid/FFmpeg renders ProRes 4444 only as 10 bit, but not as 12 bit.
Problem fix: No any fix yet, because it is just a FFmpeg limitation https://trac.ffmpeg.org/ticket/8054

Problem: No correct NCLC color tags written to MOV container.
Problem fix: Manually add tags with JESExtensifier, AMCDXVideoPatcher or with BBC QTFF Parameter Editor.

Problem: Hybrid/MP4Box adds additional empty first frame to MP4 x264/265 transcoded video.
Problem fix v1: Config -> Containers -> FFmpeg instead of MP4Box.
Problem fix v2: Use MKV container instead of MP4.

Problem: "Jumping/strobing" frames effect during playback in QuickLook or QuickTime X Player, when video was rendered to MP4 x265 with "FFmpeg instead of MP4Box" setting.
Problem fix v1: Turn off B-Frames in x265 settings.
Problem fix v2: Use MKV container instead of MP4.

Problem: Filtering -> ColorMatrix don't works with VapourSynth filters.
Problem fix: Use only Filtering -> VapourSynth -> Color -> ColorMatrix.

Problem: Filtering -> VapourSynth -> Color: Levels and Limiter works incorrectly because by mistake use YUV input instead of RGB. Also some UI controls in these filters adjusted incorrectly yet.
Problem fix v1: Levels and Limiter will work correctly if you apply dummy empty "identity.cube" LUT in TimeCube filter. TimeCube filter outputs RGB and provides proper RGB input for Levels and Limiter. Also you need to use only "Planes: all".
Problem fix v2: Problem was fixed in Hybrid UI 2020.10.11

Problem: QTGMC is not used with "Preset: Custom" "Input Types: 1 - 3" on progressive video due mistake in script.
Problem fix: There is no fix for Hybrid UI 2020.09.15 version, but problem was fixed in Hybrid UI 2020.10.11

Problem: bt470bg SD files detected by mistake as bt709 HD in x264/x265 VUI/Signalling settings if "to input" checkbox is selected.
Problem fix v1: Uncheck "to input" checkbox and set color space manually.
Problem fix v2: Problem was fixed in Hybrid UI 2020.10.11

Problem: VIVTVC TDeintMod filter don't works.
Deinterlace->VIVTVC (Vapoursynth) -> TDeintMod (SyntaxError: invalid syntax)
Deinterlace->VIVTVC (Vapoursynth) -> Misc -> TDeintMod (NameError: name 'clip1core' is not defined)
Problem fix: There is no fix for Hybrid UI 2020.09.15 version, but problem was fixed in Hybrid UI 2020.10.11

Problem: Startup slowdown and error pop-up message if for some reason you add Hybrid to "Allow the apps below to control your computer" list in macOS System Preferences -> Security & Privacy -> Accessibility.
Problem fix: Do not add Hybrid to "Allow the apps below to control your computer" list.

Problem: Requirement to disable Gatekeeper, allow to install apps from unidentified developers and add some other system tweaks. Also when you start PKG installer or Hybrid first time, it give you a message: "can’t be opened because the identity of the developer cannot be confirmed."
Problem fix: described earlier in Installation FAQ.

VapourSynth Plugins Used by Hybrid:

More detailed info about filter color models and bit depth restrictions here https://forum.selur.net/showthread.php?tid=1538
Direct download links from http://vsdb.top/vapoursynth/mac/

Last edited by shph; 11th October 2020 at 15:33.
shph is offline   Reply With Quote

deinterlace, hybrid, macos, qtgmc, vapoursynth

Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

All times are GMT +1. The time now is 01:51.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2020, vBulletin Solutions Inc.