# Difference between revisions of "User:Mjb/AviSynth"

AviSynth is a script-based "frame server" (raw video streamer) with impressive, highly configurable filtering abilities. It is normally used as a preprocessor for a general-purpose encoder/muxer like VirtualDub or FFmpeg.

## Basic usage

To use AviSynth, first install the AviSynth package. This gives you the ability to process videos via an AviSynth script (.avs file) which you must author yourself. The script takes care of making AviSynth load the input video and apply whatever filtering you specify. The output will be raw video which you must further encode in other software.

You edit your AviSynth script in a text editor. To test it, load the script into VirtualDub or other AviSynth-aware editor (instead of having those apps load the video directly). Another way of testing is to use the Windows GUI app AvsPmod, which is a nice little editor plus a preview pane, but no ability to save the processed video.

## Using AviSynth with FFmpeg

If FFmpeg was built with --enable-avisynth (as the Zeranoe builds are), an AviSynth script can be the input file for the video (only the video, not audio):

   ffmpeg -i myscript.avs -i input.ac3 ...


If you get "Unknown error occurred", it is probably because FFmpeg is 64-bit and AviSynth is 32-bit, or vice-versa; they must match.

Since you are reading raw video, you probably need to be sure to set the output aspect ratio. For example, 720x480 (3:2) input will stay 3:2 unless you specify -aspect 4/3 or whatever.

## Using AviSynth with MPEG-2 files

An AviSynth script can only open AVI files natively. Other types require special plugins. For MPEG-2 and MPEG-1 files (including .vob, .ts, .mpg), it's a multi-step process:

1. Install the DGMPGDec package, which gives you the DGIndex app and the DGDecode AviSynth plugin.
2. Load the VOB in the DGIndex app. You can tweak some options at this point, but probably shouldn't.
3. Save Project [F4]. This will generate a .d2v file, which is a frame-by-frame index DGDecode can use. It also demuxes the audio stream(s) into separate files you can use later.
4. In your AviSynth script, load the DGDecode.dll plugin (unless you copied DGDecode.dll to the AviSynth plugins directory), and now you can use MPEG2Source() with the .d2v file:
LoadPlugin("e:\apps\DGMPGDec\DGDecode.dll")
MPEG2Source("input.d2v")
...


For better quality, at some loss of detail, I suggest enabling all the standard MPEG-1/2 deblock/dering post-processing options (cpu2="xxxxxx") and maybe also add the "mosquito" noise reduction filter (to enable, get MosquitoNR plugin and extract the DLL to the AviSynth plugins directory):

LoadPlugin("e:\apps\DGMPGDec\DGDecode.dll")
MPEG2Source("input.d2v",cpu2="xxxxxx")
...


## Using AviSynth with MPEG-4 files

Use DirectShowSource with the input framerate set, e.g. this works for me with a 1080i VC-1 file demuxed to MKV from a Blu-Ray disc:

   DirectShowSource("foo.mkv",fps=30000/1001)


Another option, but painfully slow, is FFmpegSource:

   FFmpegSource2("foo.mkv")


I have not yet tried these:

• DSS2mod, which is another DirectShow frameserver.
• LSMASHSource, which is FFmpeg-based but apparently not so slow.
• QTSource, which is for QuickTime 6 & 7 formats in MOV containers.

Several more are listed at http://avisynth.nl/index.php/DSS2#Source_Filters.

## Inverse telecine

One way of doing IVTC via AviSynth is to use the TIVTC plugin.

1. Get the TIVTC package.
2. Extract tivtc.dll to "%ProgramFiles(x86)%\AviSynth\plugins".
3. Get the vInverse plugin.
4. Extract vinverse.dll to "%ProgramFiles(x86)%\AviSynth\plugins".
5. In your AViSynth Script, you can now refer to the field-matcher TFM, the duplicate frame-remover TDecimate, and the residual comb artifact remover vInverse or improved(?) vInverse2:
LoadPlugin("e:\apps\DGMPGDec\DGDecode.dll")
MPEG2Source("I:\path\to\the\input.d2v",cpu2="ooxxox")
TFM(d2v="I:\path\to\the\input.d2v")
TDecimate()
vInverse2()


I prefer this method to the pure-FFmpeg method I documented elsewhere. Image quality and reliability is the same as in FFmpeg, but having the vInverse to blend stray combed frames is quite nice.

The above is for NTSC (3:2 pulldown) sources. If your source is PAL and is progressive with a duplicate frame every 25 frames, then all you have to do is

TDecimate(cycle=25)

, no TFM or vInverse necessary.

Another option, which is only for soft telecine NTSC sources (i.e. 24 fps progressive frames encoded with pulldown flags that instruct the player to repeat certain fields, thus doing the telecine on the fly), is to have DGIndex process the fields with its "Force Film" option. Even when DGIndex identifies the content as 95%+ film, it does not always lock onto the 3:2 pattern as well as it should, in which case it's best to just stick with Honor Pulldown Flags. But when Force Film works, you get 23.976 fps from MPEG2Source and thus you can skip the TFM/TDecimate and maybe also the vInverse steps.

## Best deinterlace

Supposedly the best deinterlace (but not IVTC) option is QTGMC(). It's good, and has a number of other features, like reducing shimmer.