Skip to content

Latest commit

 

History

History

powershell_version

README.md

Powershell video deshaker script generator

Using Gunnar Thalin's excellent Deshaker-plugin can be tedious because of settings. This script generates the necessary AviSynth and VirtualDub-scripts with some default-settings so that it can be done in a single stroke. Note that VirtualDub and AviSynth are seperate applications. Do not reach out to the creators of these application because of this tools' incapability to generate working scripts.

Rationale

The idea is do most of the heavy lifting in AviSynth, yet VirtualDub is used for analysis passes. This makes it easier to use a different tool for these passes. Additionally AviSynth maintains decent documentation and description of internal filters. Note that passes are called framecount, pass1 and pass2 yet this does not reflect the number of analysis passes to run. The general steps are:

  1. Count number of frames (this can be cancelled once started).
  2. Run first deshaker pass
  3. Run second deshaker pass and first video analysis pass
  4. Repeat the second deshaker pass and run second video analysis pass

Also, this tool scaffolds a few scripts that are entirely open for modification. In some cases a script be rerun with different settings without having to rerun all. Naturally, changes cascades through the chain of scripts. So any change made to prior will require later scripts to be rerun.

Requirements

  1. VirtualDub x86-version
  2. Deshaker-plugin x86-version (maybe this VDF should be unzipped into 32-plugin folder of VirtualDub. But probably not. A specific version removed Avisynth so this is probably not relvant anymore).
  3. Avisynth ^2.6
  4. For go pro MP4 support FFMPEG DLLs are needed FFMS ^2
  5. Move files from ffm2-2.20-icl/x86 to Program Files (x86)/AviSynth 2.5/plugins

Usage

Common use case there is little more to it than:

  1. Run the command in Powershell
  • PS> .\deshake.ps1 C:\**\GOPR0260.MP4
  1. The first time around this starts VirtualDub and start reporting on total number of frames via the AviSynth-logger. The file is called deshake.GOPR0260.stats.log.
  2. Close VirtualDub as soon as it starts processing the file.
  3. Run the script again
  • PS> .\deshake.ps1 C:\**\GOPR0260.MP4.
  1. This time around a total of six scripts have been created.
  • deshake.GOPR0260.all.jobs
  • deshake.GOPR0260.framecount.avs
  • deshake.GOPR0260.framecount.script
  • deshake.GOPR0260.pass1.avs
  • deshake.GOPR0260.pass2.avs
  • deshake.GOPR0260.stats.log
  1. Open VirtualDub and select Job Control in the File-menu.
  2. Navigate to the location of scripts and open deshake.GOPR0260.all.jobs

Joining multiple clips to one

  1. Create a job as per usual i.e:
  • PS > .\deshake.ps1 C:\**\GOPR0260.MP4
  1. Interupt the framecounter once a total number of frames has been captured
  2. Change number of scripts by adding additional sources with FFAudioSource and FFVideoSource
  3. Splice them together with AudioDub and AlignedSplice.
  4. Simulating color correction in dark scenarios using the following Tweak(sat=1.20) and Levels(25, 1.33, 245, 0, 255)

Example below

LoadVirtualDubPlugin ("C:\devwork\ps-avisynth-deshake\Deshaker.vdf", "deshaker", preroll=0)
A1 = FFAudioSource("X:\2016-11-06\HERO5 Black 2\260\GOPR0260.MP4")
V1 = FFVideoSource("X:\HERO5 Black 2\260\GOPR0260.MP4")
A2 = FFAudioSource("X:\HERO5 Black 2\260\GP010260.MP4")
V2 = FFVideoSource("X:\HERO5 Black 2\260\GP010260.MP4")
# AlignedSplice(AudioDub(V1, A1).ConvertToRGB32(matrix="PC.709"),AudioDub(V2, A2).ConvertToRGB32(matrix="PC.709"))
AlignedSplice(AudioDub(V1, A1),AudioDub(V2, A2))
Trim(28853, 29508)
ConvertToYUY2()
Tweak(sat=1.20)
Levels(25, 1.33, 245, 0, 255)
# Deshaker("19|1|30|4|1|0|1|0|640|480|1|2|1000|1000|1000|1000|4|1|3|2|8|30|300|4|C:\\usr\\xyz\\Deshaker.log|0|0|0|0|0|0|0|0|0|0|0|0|0|1|10|10|5|10|0|0|30|30|0|0|1|0|1|1|0|10|1000|1|90|1|1|20|5000|100|20|1|0|ff00ff")

Additional info

  1. Blog post on how to do this on linux with WINE
  2. http://avisynth.nl/index.php/FAQ_loading_clips