This forum uses cookies
This forum makes use of cookies to store your login information if you are registered, and your last visit if you are not. Cookies are small text documents stored on your computer; the cookies set by this forum can only be used on this website and pose no security risk. Cookies on this forum also track the specific topics you have read and when you last read them. Please confirm whether you accept or reject these cookies being set.

A cookie will be stored in your browser regardless of choice to prevent you being asked this question again. You will be able to change your cookie settings at any time using the link in the footer.

[GUIDE] VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS
This VapourSynth + Plugins + Scripts + Hybrid [2020.10.10] DMG package includes:

VapourSynth-R52 Installer
Downloaded from
VapourSynth Plugins for Hybrid
Downloaded from
Hybrid UI 2020.09.15 (including internal components updates 2020.10.10)
Downloaded from
XQuartz 2.7.11 (Required by Hybrid to read image sequences)
Downloaded from
D2V Witch v4 (Required by Hybrid to process VOB files and DVDs)
Downloaded from
VulkanSDK (Required by Waifu2x nvk resizer filter)
Downloaded from
JESExtensifier 3.0.5 (It helps to change aspect ratio and other metadata tags inside MOV container)
Downloaded from
You can also use instead AMCDXVideoPatcher or BBC QTFF Parameter Editor command line tool

Arrow DOWNLOAD package from Google Drive:

[Image: pFO3K5h.jpg]

Quick FAQ for Beginners:

VapourSynth 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 environment to work. VapourSynth support external Plugins (.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 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 is a cross-platform UI wrapper for VapourSynth filters, scripts and a bunch of other video tools It use well known FFmpeg library 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 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.

[Image: IH2PsME.jpg]

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 "" 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 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/ 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 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 ./
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 + ."
[Image: sTH4w4Y.jpg]
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
Note that Hybrid UI 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 "" first time, it may give you a message: "can’t be opened because the identity of the developer cannot be confirmed."
[Image: F4dYAia.jpg]
To fix this problem mouse right-click on "Hybrid 2020.09.15 and Plugins.pkg" or "", select in menu "Open", and next press "Open" button in pop-up window.
[Image: pwOBusH.jpg]

Usage FAQ:

[Image: 8DyEZlg.jpg] Open File
[Image: gNGscEF.jpg] Set Output Folder
[Image: AJtd1dc.jpg] 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

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: VapourSybth Preview error message (setButton called with icon or button as nullptr) if turn on "Filter View" and use "disableIcons=true" in "misc.ini" file.
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
Direct download links from
  1. AddGrain
  2. Anime4KCPP [8-bit only]
  3. AWarpSharp2
  4. BiFrost [8-bit only]
  5. Bilateral
  6. BilateralGPU (Depreciated, use CuPy)
  7. BM3D
  8. Bwdif
  9. CAS (Requires macOS 10.14+)
  10. CNR2 [8-bit only]
  11. CTMF
  12. D2VSource (included in VapourSynth installer)
  13. DCTFilter
  14. Deblock
  15. DeblockPP7
  16. DeCross [8-bit only]
  17. Dedot [8-bit only]
  18. DegrainMedian
  19. Descale
  20. DFTTest (Requires macOS 10.14+)
  21. dgdecnv (Windows only)
  22. DGHDRtoSDR (Windows only)
  23. DotKill [8-bit only]
  24. EdgeFixer
  25. EEDI2
  26. EEDI3 (included in VapourSynth installer)
  27. EEDI3m
  28. FFMS2 (included in VapourSynth installer)
  29. ffmtconv
  30. FFT3DFilter
  31. Fix Telecined Fades
  32. Flash3kyuu Deband
  33. Fluxsmooth
  34. HQDN3D [8-bit only]
  35. ImageMagick (included in VapourSynth installer)
  36. IT [8-bit only] (Requires macOS 10.15+)
  37. KNLMeansCL (Produce artifacts and may cause Kernel Panic)
  38. LGhost
  39. LSMASHSource (included in VapourSynth installer)
  40. MiniDeen
  41. MSmooth
  42. MVTools (v20 and v21 works well. v22 and v23 error on render "crashed: Helper1, exitCode: 11")
  43. MVTools_SF (Needs C++20, not implemented in macOS yet)
  44. NEO_FFT3D (l33tmeatwad report that it crashes)
  45. NNEDI3
  46. NNEDI3CL
  47. ReadMpls
  48. Retinex
  49. SangNom
  50. SangNomMod [8-bit only] (Conflicts with SangNom due same namespace)
  51. SceneChange
  52. SRMD (Requires macOS 10.15+ and Vulkan SDK)
  53. SSIQ [8-bit only]
  54. SVP/Interframe [8-bit only] (Commercial filter)
  55. TCanny
  56. TDeintMod
  57. TempLinearApproximate
  58. TemporalSoften
  59. TimeCube
  60. ToneMap
  61. TTempSmooth
  62. VagueDenoiser
  63. vcmod
  64. VFRToCFR
  65. vs_avsreader (Windows only)
  66. vsfiltermod [8-bit only] (Windows only)
  67. vsrawvideo
  68. Waifu2x-w2xc (Very slow. If possible use Waifu2x NCNN Vulkan instead)
  69. Waifu2x NCNN Vulkan (Requires macOS 10.15+ and Vulkan SDK)
  70. Yadifmod
  71. ZNEDI3
as a side note:
There are also pre-compiled versions of MP4Box available (, which are part of gpac.
Note that it is probably not enough to replace just the mp4box binary, some of the libraries in MacOS/lib-folder might have to be updated too (they too come with gpac).
Ok, i will try to update it too. One quesion here:
/Applications/ folder contains 28 .dylib files
/Applications/GPAC/Contents/MacOS/lib folder contains 63 .dylib files

Should i update only 28 old files or should place all 63 new files to Hybrid?

Here is full list of new files:

Most of the libs that are in the lib folder of gpac should not be needed since mp4box does not usw them.
Also some of the libs in Hybrids lib folder are from Mediainfo iirc. -> when updating mp4box only replacing a few of the 28 libs should be enough.

Cu Selur
Ok, so i select same 28 files now. What exact dylib files from this list should i replace to keep things safe and stable?

Also in addition to libx264.155.dylib i see new libx265.179.dylib file inside It feels like may be something required by new MP4Box version? Or just ignore it?
Hybrid contains only libx264.148.dylib

Seither x264 nor x265 libs are required by mp4box, No clue which libs are needed since it is simply to long ago that I used a Mac.
VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.23
Package now includes D2V required by Hybrid to process VOB files.
Updated FAQ.
Links to discussion forums.

VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.28
Package now includes (it help to change aspect ratio and other metadata tags inside .MOV container)
Updated FAQ.

VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.29
VapourSynth R49
Updated FAQ.
Arrow Download from same Dropbox folder:
Here are few more macOS related questions:
1. I have AMD RX 580 GPU, and in Hybrid UI in many filters i see option to use GPU and OpenCL. But checkmarks are always inactive. Is it possible somehow to turn those things on on macOS? Or maybe they inactive due some limitation in VapourSynth plugins? Or they are for Nvidia cards only?
[Image: vnVj1bt.jpg]
[Image: n4fBuyW.jpg]

2. When i switch QTGMC presets to custom mode, Sharpneess value is always inactive. Is this a bug?
[Image: uqJqQaY.jpg]
1. about OpenCL support in some filters/scripts: as far as I know there is no needi3cl available for MacOS X which is why all options that relate to it are disabled.
Same for some other filters.
2. yes, that's a bug. (happens when Vapoursynth is available but not Avisynth)

Cu Selur
Strange. There is a libnnedi3cl.dylib as well as libnnedi3.dylib in plugins folder.
[Image: VmAoM5B.jpg]

Quote:2. yes, that's a bug. (happens when Vapoursynth is available but not Avisynth)
That is odd problem Sad

Forum Jump:

Users browsing this thread: 1 Guest(s)