[GUIDE] VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - Printable Version +- Selur's Little Message Board (https://forum.selur.net) +-- Forum: Hybrid - Support (https://forum.selur.net/forum-1.html) +--- Forum: Problems & Questions (https://forum.selur.net/forum-3.html) +--- Thread: [GUIDE] VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS (/thread-1279.html) |
VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 15.03.2020 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/x8o2q07zyb6gp4h/AACsOD6p0cWeqysR-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/folders/1tley3-jnXjDQCKagKAS4WLeiSqIaA5D6?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: csrutil disable Allow install apps from unidentified developers by typing in Terminal: sudo spctl --master-disable 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 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 Type your password. Press "Enter" on keyboard. For more details see additional FAQs: https://www.imore.com/how-open-apps-anywhere-macos-catalina-and-mojave https://www.imore.com/how-turn-system-integrity-protection-macos https://apple.stackexchange.com/questions/373176/disable-the-use-of-the-com-apple-quarantine-extended-attribute-on-mojave https://apple.stackexchange.com/questions/372084/macos-catalina-app-is-damaged-and-cant-be-opened-you-should-move-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: cd /Volumes/vulkansdk-macos-1.2.170.0 Run the following command to install: sudo ./install_vulkan.py 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/
RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - Selur - 15.03.2020 as a side note: There are also pre-compiled versions of MP4Box available (https://gpac.wp.imt.fr/downloads/gpac-nightly-builds/), 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). RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 15.03.2020 Ok, i will try to update it too. One quesion here: /Applications/Hybrid.app/Contents/MacOS/lib 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: liba52.0.dylib RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - Selur - 15.03.2020 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 RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 15.03.2020 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 GPAC.app It feels like may be something required by new MP4Box version? Or just ignore it? Hybrid contains only libx264.148.dylib liba52.0.dylib RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - Selur - 15.03.2020 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. RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 29.03.2020 VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.23 Changes: Package now includes D2V Witch.app required by Hybrid to process VOB files. Updated FAQ. Links to discussion forums. VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.28 Changes: Package now includes JESExtensifier.app (it help to change aspect ratio and other metadata tags inside .MOV container) Updated FAQ. VapourSynth + Plugins + Scripts + Hybrid package update 2020.03.29 Changes: VapourSynth R49 Updated FAQ. Download from same Dropbox folder: https://www.dropbox.com/sh/hzy3f0zyuyu4yqu/AAAQ9Dn4WFUG8huLOy4VO5zla?dl=0 RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 07.04.2020 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? 2. When i switch QTGMC presets to custom mode, Sharpneess value is always inactive. Is this a bug? RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - Selur - 07.04.2020 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 RE: VapourSynth + QTGMC Deinterlace + Hybrid UI FAQ for macOS - shijan - 07.04.2020 Strange. There is a libnnedi3cl.dylib as well as libnnedi3.dylib in plugins folder. Quote:2. yes, that's a bug. (happens when Vapoursynth is available but not Avisynth)That is odd problem |