DeshakerRedux is a dedicated tool for Deshaker which adds some additional features not found when using AviDub.  These features include: (1) a turbo option to speed up Pass 1 processing; (2) a dialog for easily creating masks for inclusion or exclusion of areas to be analyzed during Pass 1 processing; (3) dedicated deshaker log files created so that Pass 1 and/or Pass 2 can be executed in a batch fashion; (4) Option to add head and tail time to events thus eliminating the "bobble" that can often be seen during the first few frames; (5) addition of VirtualDub filters that can be applied during Pass 2 including Crop-Resizing, Gaussian blue, Sharpen, and Unsharp Mask; and (6) a new dialog for crop-resizing.  For detailed explanations of the many parameters, it is recommended that the user visit the Deshaker website.  For that reason, only limited information is provided here.

1. What to Render.

a. Events .  Multiple events may be selected from a single track. The rendered media file may be added back to the event as a Take, rendered to  New Track or just saved.

b.   Launches Otter NavBar which permits the user to navigate the timeline, select tracks and events, and set in and out points for render loop.

b. Loop region .  If selected, the loop region will be rendered to a New Track or just saved. 

c. Regions .  If selected, all regions will be rendered to a New Track or just saved.

d. Selected Regions.      Opens a dialog where the user may select which regions to render.  Region names may be directly entered or edited and will be saved in the project.

2. What to Keep .

a.Event Fx .  If checked, event Fx will be kept

b. Pan/Crop Settings. If checked, pan/crop settings will be kept.

c. Original Audio.   If checked, the audio for the selected event will be rendered.  A copy will be made and all fades and FX removed.  If unchecked, audio may still be included by muting unwanted tracks.  No copy will be made and fades and FX will not be removed.

3. Processing Options.

a. Pass 1.  If checked Pass 1 will be executed.

b. Pass 2.  If checked Pass 2 will be executed.

c. Add time.  If checked, both head and tail time will be added to events selected for processing.  Note that this applies only to Events.

d. No Template Check.  A template check is available which compares the properties of the selected render template with the properties of the media file that is being rendered.  If there is a mis-match (For example, the media file is interlaced, but the render template is progressive) a warning is shown with options to abandon or continue the render.  There is a another check once the rendered file is added back to the timeline.  If checked, this template check will be by-passed altogether. If checked, the template check will be disabled.

e. Rolling Shutter.  If checked, a rolling shutter correct will be applied to both passes.  The amount of correction may be changed in the updown box.  Please see the Deshaker website which has a listing of recommended settings for specific cameras.

4. Template.  Choose the desired template from the list of templates shown in the dropdown list.  Note that all templates can be found in the folder "C:\ProgramData\HappyOtterScripts\VirtualDub FilterSettings" unless a different folder has been chosen using ToolFileSetup. 

a.   Adds a new template.  If clicked, a new name can be entered into the dropdown list box.  Templates must always begin with the text "Deshaker".

b.   Deletes the selected template.

c.   Edit the script in VirtualDub2.  If clicked, VirtualDub open and loads the script and displays the filter settings which can then be changed.

d. Fx  Indicates the presence of additional filters in selected template.  If the background is Green, additional filters are present.

e.   Opens the Advanced Options dialog.

f.   Clears deshaker logs.

5. Pass 1 Parameters.  The most widely-used  pass 1 parameters may be set using this dialog.  Additional parameters may be found in the Advanced Options dialog.

a. Scale. The maximum scale to do the image matching on. Full is best but very slow.

b. Pixels. How many pixels in the blocks to actually use when matching. All is best but very slow.

c. Block Size. The width and height of the blocks used during the image matching.

d. Turbo.  If checked, frame size will be temporarily set to 1280 x 720 for Pass 1 processing which results in a significant speed increase for both HD and UHD media. 

e. Detect Rotation. If ticked, rotation motion vectors will be detected.

f.  Detect Zoom. If ticked, changes in zoom will be detected.

g. Detect Scene Changes.  Detects scene changes based on the threshold selected.  Scene detection is necessary only for loop, region, or project renders that span multiple events.  If event processing is selected, this should not be checked.

h. Apply Mask.  If checked, the   button is enabled which opens the Create Mask dialog.

6. Pass 2 Parameters.  The most widely-used  pass 2 parameters may be set using this dialog.  Additional parameters may be found in the Advanced Options dialog.

a. Borders.  Edge compensation options may be selected from the dropdown list.  Depending on the option selected, additional settings may be displayed.  For an explanation of the different options, see the Advanced Options dialog or go to the Deshaker website.

b.  Extra Zoom. An additional zoom factor to apply to the video.

c.   Resets all of the smoothness and max limits parameters to their default values.

d.   Fix Pan. Sets the smoothness values to -1 which fixes the camera position to the first frame.

e. Smoothness. These values determine how smooth the motion will be. You can set a parameter to 0 to turn off the smoothing completely. If you enter -1 as smoothness you will get "infinite smoothness", meaning the camera will appear to be stationary at the position of the first frame.

f.  Max Limits. To keep the corrections (that cause the black borders) small during fast pans (for example), you can limit the maximum corrections. Especially when using Fixed zoom as edge compensation these settings keep the zoom from being too large. What these settings really do is automatically lower the motion smoothness values in certain parts of the video when it becomes necessary.

7. VirtualDub Render Template.

a.Select Render Template.    Left-click on the folder icon    which will open the VirtualDub Render Settings folder from which a render setting file may be selected.  It will then appear in the text box next to the folder icon.

b.Edit Render Template .  To edit a Vudb render setting file, left click on the pencil icon  which will open VirtualDub and load the settings file.  Changes may be made and saved.

c. Render Template Properties.  Once a render template is selected, the following properties will be displayed: (1) FourCC code; (2) Container; (3) Audio Encoder; and (4) Bitrate.

8. How to Save.

a. Add as Take.  This option is available only for Event renders.  If selected, the rendered media file's videostream will be added back to the original video event as a Take.   If Original Audio is checked in What to Keep, the rendered file's audio stream will be added as a Take to the selected event's audio track.

b. Add to New Track. This options is available for all types of renders.  If selected, the rendered file's videostream  will be added to a new track entitled "Deshaker Video".  If Original Audio is checked in What to Keep, the rendered file's audio stream will be added to a new track entitled "Deshaker Audio".

c. Save Only. If selected, the rendered media file will just be saved.  It will not be added back to the timeline. 

d. Add File Tag. If checked, a File Tag will be added to the name of the rendered event. The desired name can be entered in the textbox.

9. Where to Save.

a. Specific Folder Location .  Rendered media files are stored in a specific folder selected by the user.  A left-click on the folder icon opens the browse folder dialog from which the location is selected or a new folder created.  If "Create Project Name Sub-folder" is checked, a sub-folder will be created in that location with the name of the subfolder being the Project name.

b. Sub-folder of Project Folder. Rendered media files are stored in a sub-folder in the  folder where the Vegas project is located.  The name  of the sub-folder may be entered into the textbox on  the right.

c. Sub-folder of Media File Folder .  Rendered media files are stored in a sub-folder in the  folder where the media file is located.  The name of  the sub-folder may be entered into the textbox on the right.This option is available only for event renders.

10. After Render.

a. Show Stats. If checked, render statistics will be shown upon render completion.


b. Open Folder. If checked, the rendered file folder will be opened and the file selected.

c. Preview. If checked, the rendered file will be opened in Media Player Classic - Home Cinema for immediate playback. A complete description of this dialog may be found in  OtterPlay .