AviSynthPlus Comprehensive Guide

AviSynthPlus Comprehensive Guide

Professional Instructional Document

Introduction

This guide provides a detailed overview and step-by-step instructions for setting up and using AviSynthPlus, along with various plugins and scripts. It is designed for advanced users and developers who are looking to optimize their video processing workflows using AviSynthPlus.

The document covers everything from installation and setup to advanced usage, updating, and troubleshooting. It is meant to serve as a comprehensive resource, ensuring users have all the necessary information to work effectively with AviSynthPlus.

Prerequisites

Required Software

System Requirements

Ensure your system meets the minimum and recommended specifications for AviSynthPlus:

  • Minimum: Windows 7 or later, 2GB RAM, 500MB disk space.
  • Recommended: Windows 10, 8GB RAM, 1GB disk space, multi-core processor.

Set up AviSynth+ Environment

This section guides you through the initial setup of the AviSynthPlus environment. Follow the instructions carefully based on your current setup:

1a. Initial Installation for New Users

  1. Install Microsoft Visual C++ Redistributable Runtimes.
  2. Install the latest version of AviSynth+.

1b. Upgrading from Previous Versions

  1. Uninstall the existing version of AviSynth.
  2. Delete the following folders and registry keys:
    • C:\Program Files (x86)\AviSynth
    • HKEY_CURRENT_USER\Software\Avisynth
    • HKEY_LOCAL_MACHINE\SOFTWARE\Avisynth
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Avisynth (for 64-bit OS)
  3. Install the latest version of AviSynth+.

2. Install DevIL SDK

Download DevIL 1.8.0 SDK for Windows and follow these steps:

  • For AviSynth+ 32-bit: Copy DevIL.dll from lib\x86\Release to C:\Windows\SysWOW64.
  • For AviSynth+ 64-bit: Copy DevIL.dll from lib\x64\Release to C:\Windows\System32.

Avisynth+ Plugins Pack

The plugins pack is an essential component for enhancing the functionality of AviSynthPlus. This section covers the installation, usage, and troubleshooting of the plugins pack.

Download and Installation

The plugins pack can be downloaded HERE. Note the following important points:

  • From plugins_pack_r73, runtime files for mlrt_ov/mlrt_ncnn/mlrt_ort, models for rife/mlrt_ov/mlrt_ncnn/mlrt_ort, and LUTs for lineartransformation must be downloaded manually.
  • This change has reduced the size of the plugins pack from r73 compared to r72.
  • If these components are missing and are set to true, you will see warnings in the command window.

For more detailed instructions, please refer to the following links:

Old Versions

You can access older versions of the plugins pack HERE.

Updating AviSynth+

To ensure you have the latest features and performance improvements, regularly updating AviSynth+ is recommended.

Why Update?

Official releases may lag behind, and interim bug fixes and optimizations are often available in newer builds.

Manual Update Process

  1. Download the latest AviSynth+ Clang builds HERE.
  2. Modify the default locations at the top of avisynth_updater.bat if your plugin directories differ from the defaults.
  3. Run avisynth_updater.bat as Administrator. Ensure it is located in the same folder as the downloaded Win32 and x64 folders.
  4. Select the desired AviSynth+ version to update.

Advanced Tools and Scripts

AvsPmod

AvsPmod is a powerful script editor for AviSynth scripts. Download the latest version from HERE.

Instructions:

  • Use AvsPmod_v2.*.Windows_x86-32.zip for AviSynth+ x86.
  • Use AvsPmod_v2.*.Windows_x86-64.zip for AviSynth+ x64.

In recent versions, the default YUV->RGB conversion used for displaying content or saving as an image has changed. To view the matrix used on the status bar:

  • Go to Options -> Program Settings -> Video -> Customize video status bar...
  • Add %DYR to display the matrix information.

fdkaac, qaac, sox

Download the latest versions of fdkaac, qaac, and sox HERE.

x264 with tMod (jpsdr) Patches

Download the patched x264 versions HERE or HERE. Source code is available HERE.

These builds have a few minor differences from jpsdr's original builds, including:

  • Patch for building with mingw on Linux instead of Windows
  • Audio is disabled
  • Unapplied patches:
    • AviSynth 16-bit hack (AviSynth+ native high bit depth is officially supported)
    • f3kdb usage for converting from higher bit depth to output bit depth
    • Double unicode buffer
    • Weightp 2 for Blu-ray
    • rbsp_alignment_zero_bit

libdcadec.dll for eac3to

Built from the master branch, which has 30 commits on top of the latest release on GitHub. The included libdcadec.dll in eac3to is even older than the latest release. Download the updated libdcadec.dll HERE.

Audacity 3.5.1

Download the latest version of Audacity HERE.

  1. Download ffmpeg libs from HERE.
  2. Follow the manual installation instructions HERE.

Specific Plugin Information and Scripts

Banding Detection

The banding detection script is essential for identifying and correcting banding issues in video. Installation instructions and the script are available HERE.

f3kpf and lfdeband

These scripts are vital for handling specific video processing tasks in AviSynth+. Download and usage information can be found HERE and HERE.

Comparison Uploader in Python

A Python script for uploading comparison images is available HERE. Usage instructions:

usage: compup-ptp [-h] [-v] [-i [IMAGES [IMAGES ...]]] [-c COMPARES] [-o]

optional arguments:
  -h, --help            Shows this help message.
  -v, --version         Shows version.
  -i [IMAGES [IMAGES ...]], --images [IMAGES [IMAGES ...]]
                        image sources. (default: *.png)
  -c COMPARES, --compares COMPARES
                        compare names, comma separated. (default: source, encode)
  -o, --oxipng          use oxipng before uploading. (default: false)

Example:

compup-ptp -c 'WEB-DL, DVD' -i compares/*

Changelog and Version Control

Track the changes made across different versions of the plugins pack, scripts, and tools. The comprehensive changelog is available HERE.

Manage and access different versions of the scripts and tools via the relevant repositories:

Additional Resources and References

Below is a list of external resources and references that can further enhance your understanding and usage of AviSynthPlus:

Appendix

Scripts and Command Line Tools

This section includes sample scripts, command-line usage examples, and detailed explanations of various command-line arguments used in AviSynthPlus.

:: Sample AviSynth Script
AviSource("video.avi")
ConvertToYV12()
fft3dfilter(sigma=2)
Tweak(bright=5, cont=1.2)
Trim(0,500)

Troubleshooting

If you encounter issues during setup or usage, refer to the following troubleshooting tips:

  • Missing DLLs: Ensure all required runtime libraries are installed and correctly placed in the system directories.
  • Script Errors: Double-check syntax and paths in your AviSynth scripts. Refer to the warnings section for specific issues.

© 2024 AviSynthPlus Documentation | All Rights Reserved

Comments

Post a Comment

Popular posts from this blog

Dolby Vision Metadata RPU Editing Guide Dolby Vision Metadata RPU Editing Guide Professional Instructional Document Introduction Workflow Processing Dolby Vision Profile 7 FEL Encoding Profile 5 to HDR10 Hybrid Release Resources Introduction In almost all cases, the source Dolby Vision metadata RPU (Reference Processing Unit) needs to be edited for use in an encode or another video. This guide will walk you through the process using dovi_tool and, for most examples, ffmpeg . Suggested RPU Editing Workflow Extract the RPU with mode 0 ffmpeg -i source.mkv -c:v copy -vbsf hevc_mp4toannexb -f hevc - | dovi_tool -m 0 extract-rpu - It's possible this step can fail with invalid files (e.g., from Apple). Remove mode 0 if you know what you're doing. Sync and Compare Video Files ...
Read more
Comprehensive Deew Guide for Dolby Encoding Comprehensive Deew Guide for Dolby Encoding In-Depth Reference and How-To for Using Deew with Dolby Encoding Engine Introduction Installation Usage Advanced Configuration Troubleshooting Conclusion Introduction Welcome to the comprehensive guide on using Deew , a powerful command-line tool that simplifies the process of working with the Dolby Encoding Engine (DEE) across various platforms including Linux, Windows, and macOS. This guide will take you through installation, usage, real-world examples, and advanced configurations, providing you with the knowledge to effectively encode audio with Dolby technologies. Whether you're dealing with Dolby Digital (DD), Dolby Digital Plus (DDP), AC-4, or TrueHD formats, Deew streamlines the encoding process, making it an essential tool for professionals...
Read more