View Single Post
Old 16th April 2020, 13:30   #1  |  Link
shph
Registered User
 
Join Date: Mar 2020
Posts: 134
VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS

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

VapourSynth-R57 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 2022.03.20
Downloaded from https://www.selur.de/downloads
MKVToolNix 53.0.0 (The last version compatible with macOS 10.14 Mojave)
XQuartz 2.8.1 (Required to read image sequences by Hybrid)
Downloaded from https://www.xquartz.org/
D2V Witch v4 (Required to read and process VOB files and DVDs in Hybrid)
Downloaded from https://forum.doom9.org/showthread.php?t=175522
VulkanSDK 1.3.204.1 (Required to run Waifu2x nvk, SRMD, Placebo and other Vulkan-based VapourSynth filters in Hybrid)
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:
/Library/Frameworks/VapourSynth.framework
Dependencies Libraries installed to:
/Library/Frameworks/VapourSynth.framework/lib/
External Plugins installed to:
/Library/Frameworks/VapourSynth.framework/lib/vapoursynth/
Scripts installed to:
/Library/Frameworks/VapourSynth.framework/lib/python3.8/site-packages/
Some legacy apps may read Dependencies Libraries and Pugins from legacy location:
/usr/local/lib/
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 opposite to Windows version it don't contains pre-installed VapourSynth on macOS. To make QTGMC work on macOS you need to install and adjust VapourSynth with all required plugins and scripts separately.




Prepare to Installation FAQ:

Hybrid 2022 contains a lot of fundamental internal changes. To avoid preferences conflict you need COMPLETELY UNINSTALL LEGACY HYBRID 2018 or 2020 VERSION, DON'T LAUNCH THAT LEGACY VERSIONS 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:
Code:
csrutil disable
Press "Enter" on keyboard and restart computer

Allow install apps from unidentified developers by typing in Terminal:
Code:
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:
Code:
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:
Code:
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:
https://www.imore.com/how-open-apps-...ina-and-mojave
https://www.imore.com/how-turn-syste...otection-macos
https://apple.stackexchange.com/ques...bute-on-mojave
https://apple.stackexchange.com/ques...ve-it-to-the-t

Hybrid 2022 is fully compatible with macOS 10.14, 10.15 and 11.0, but i personally still recommend to use macOS 10.14.6 Mojave and don't see any practical reason move to newer macOS versions with increased security restrictions and without 32-bit apps support.


Installation FAQ:

1. Open "VapourSynth+Plugins+Scripts+Hybrid-2022.03.20.dmg"
2. Install "VapourSynth-R57.pkg"
3. Install "Hybrid 2022.03.20 and Plugins.pkg"
4. Install "XQuartz.pkg" (optional)
5. Install Vulkan SDK (optional)

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 2022.03.20 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 2022.03.20 and Plugins.pkg" or "Hybrid.app", select in menu "Open", and next press "Open" button in pop-up window.


UI Customization FAQ
It is possible (and highly recommended) to use native system buttons with text names instead of custom UI icons and also adjust UI font size from Menu -> View.

It is also possible to use "misc.ini" file to change some other hidden settings:
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 info about customization using "misc.ini" file here https://forum.selur.net/showthread.php?tid=10.


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 -> 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 -> -> Matrix -> 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 -> Frame -> Resize -> Resizer: NNEDI3
Neural network resizer NNEDI3 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


Known Bugs and Fixes:

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: New versions of FFmpeg may produce incorrect .mov file duration when source video is very short (less than 1 second).
Problem fix: Config -> Input -> Decoding -> FFmpeg vsync handling: Set it to "auto"

Problem: Error message "Title selection, returned no title!" when opening DVDs that contain multiple short films, cartoons or music videos that have length less than 10 minutes.
Problem fix: Config -> Input -> Ignore playlists with: -> Set "Minimum length Mpis/DVD (min)" to 15/1

Problem: When opening DVDs that contains large amount of Titles, Hybrid UI may freeze for about 1-3 minutes during "Analyzing a/v for title X of XX" and same time "tccd" process in system monitor start to load CPU. "tccd" process also may start in background after finished DVD remuxing job.
If force close Hybrid while "tccd" process is running, it will load CPU forever until you restart computer.

Problem Fix: "tccd" is normal system process that always runs on computer but in normal situation it don't loads CPU. Keep an eye on "tccd" process in system monitor and don't close Hybrid while this process loads CPU. Process usually finished automatically in about 1-3 minutes and Hybrid UI is back to normal.

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: Do not use "FFmpeg instead of MP4Box"
Problem fix v2: Use MKV container instead of MP4.

Problem: In disabled filters when cursor appears over areas with checkboxes, vertical scrolling suddenly stops.
Problem fix: No any fix yet, because bug (or feature) in qt6 interface framework.

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: Green Fullscreen window button sometimes may became active, but may not work correctly.
Problem fix: Switch to Fullscreen mode using Menu -> View

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.

Problem: Some newer plugins are not compatible with macOS 10.14.6 Mojave.
Problem fix: Use macOS 10.15 or higher if you need those plugins.

Problem: Vulkan SDK version 1.2.176.1 and higher fails to install on macOS 10.14.6 Mojave. https://github.com/KhronosGroup/MoltenVK/issues/1360
Problem fix 1: Use macOS 10.15 or higher.
Problem fix 2: For Mojave use Vulkan SDK version 1.2.170.0

Open "vulkansdk-macos-1.2.170.0.dmg"
Open Terminal & browse to the vulkan mount point with the following command:
Code:
cd /Volumes/vulkansdk-macos-1.2.170.0
Press "Enter" on keyboard.
Run the following command to install:
Code:
sudo ./install_vulkan.py
Press "Enter" on keyboard.
Type your password.
Press "Enter" on keyboard.


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; 20th March 2022 at 16:08.
shph is offline   Reply With Quote