A script for either re-wrapping or transcoding media files into a format that can be more easily decoded on the Vegas timeline.  If re-wrapping is possible, the media file's videostream and audiostream remain unchanged.  These are placed into a new container which can then be decoded by Vegas.  Transcoding involves the re-rendering of the media file's videostream and audiostream into a format that can be better decoded on the Vegas timeline.  Ideally, a lossless VFW codec such as UtVideo or MagicYUV should be used for the videostream, but this can result in very large file sizes.  Transcoding options include direct x264 renders as well as VFW codecs such as Cineform using VirtualDub.

1. Type of Import. A drop-down list of media for which a transcoding or rewrapping option is available.


2. Add Files.  A left-click of the folder-only (left)  icon opens the browse folder dialog in which an entire folder may be added for processing.  A left-click on the folder-explore (right) icon opens the file dialog in which multiple files may be selected for processing.  Click on the reset button    to remove all files, selections, and to start over.

3. Selected Files to Import . An info box  which  shows the list of files to be processed. 

a.   If clicked, detailed stream information will be shown.


b.  Moves the selected items up in the listbox.

c.  Moves the selected items down in the listbox.

d.  Removes the selected media files from the listbox.  Note that it does NOT delete the file from your hard drive.

4. Processing Options .  Once the Type of Import has been selected, the available processing options are shown in this info box.  There are two main processing options rewrapping or transcoding.  At the moment rewrapping options are limited and available only for a few types of media, while transcoding is generally available for all media. 

a. Rewrap .  If rewrap is selected, both the audio and video streams are simply copied into a new container.  E.g. iPhone video is saved in an mov container.  It can be quickly re-wrapped into an mp4 container and oftentimes can be more easily decoded when imported to the Vegas timeline.  If re-wrapping is possible, both the audio and video streams remain unchanged.

b. VFR to CFR . For MKV, MP4 and MOV containers, a rewrapping option is available which enables the conversion of Variable Frame Rate (VFR) video to a Constant Frame Rate(CFR) which Vegas prefers.  This can be especially useful for cell phone and tablet video recordings which usually record using VFR.  There is no transcoding of the video stream.  Only the timecode is changed. For MKV containers, the VFR to CFR option is selected by default.  

c. Transcode .  If transcode is selected, the video stream will be re-rendered.   For transcoding, there are usually four container options--avi, mp4, mov and png.  If mp4 or mov is selected, the drop down list will contain available x264 render templates.   If avi is selected, the drop down list will contain available Video for Windows render templates.  These templates include those that were part of the HOS installation package and whatever new render templates the user has created using AviDub.  Avi processing makes use of VirtualDub FilterMod while x264 processing uses FFmpeg. If png is selected, an image sequence of lossless png's will be rendered with choice of bit depth.

d.   For 8bit x264 renders using FFmpeg, clicking this icon button toggles between full-range (0-255) and limited-range (16-235).  This option is not available when using 10bit x264 rendering.

c. Container . A drop down list of possible containers.

e. FFmpeg.  If selected, the drop down list will show a list of available render templates.  For x264 encoding, new templates can be created using the Encoder Settings dialog.

f.    When clicked, the following x264 rendering template window is shown.  Note that the same window can be loaded when x264 rendering is selected in AviDub, ProxyAssist, and RenderEvents.  Templates created in one script may be used in other scripts as well.  A complete description of this window may be found in the help section describing x264 Render Templates in detail.

g. VirtualDub. If selected, the drop down list  will show a list of available VirtualDub render templates.  New templates can be added by launching VirtualDub from OtterBar or OtterInfoBar and creating and saving new compression settings files.

5. Video Options .

a.Crop Button  If clicked, a crop settings dialog open which enables the user to crop the incoming media file. 


b. Trim Head .  The number of frames to be trimmed from the beginning (head) of the media file.

c. Trim Tail .  The number of frames to be trimmed from the end (tail) of the media file.

d. Set Frame Rate. A dropdown list of available frame rates for the transcoded files.  If custom is selected, the frame rate may be entered manually. 

e. Extract . If selected, subtitles and chapters may be extracted from MKV and MP4 files.

(1) Subs.  Subtitles (subrip) can be extracted from the media files and will be saved as files with a .srt extension.  They cannot be directly added to the Timeline using HappyOtterScripts.  To add these to the timeline, it is recommended that the Text Generation Wizard in Vegasaur be used.

(2) Chapters. Chapters will be extracted and added as Markers on the Vegas timeline.  If available, chapter titles will be added as Marker labels.

5. Still Image Options .  If stills are to be imported, the Video Options dialog is replaced by a Still Image Options dialog.  


a. Resizing to either a custom width or factor of the project width. 

b. Cropping   If selected, the following crop dialog is shown.


c. Length.  Event length if added to the timeline.

d. Format. Choice of formats including bmp, jpg, png and tif.

e. Small Image Import.  If ticked, a small image can be imported and placed on a transparent background corresponding to the project dimensions.  This enables small images to be imported to the timeline without the "zooming" that normally occurs when such images are added directly to the timeline.

6. Audio Options .

a. Copy Audio . If checked, the selected audio streams wills be copied and rendered to new audio files. 

b. Re-render To:

(1) AAC . Selected streams will be re-rendered to the aac format at a bit rate of 256K

(2) PCM . Selected streams will be re-rendered to 16bit 48Khz pcm audio.

c. Add Delay(ms) .  Transcoding and re-wrapping can often lead to loss of audio sync. Use positive values if the audio is too early or negative values if the audio is late.  Time is in milliseconds with a  max and min of 2000 msec. 

7. Save Options .

a. Add to Project Media.  If checked, the transcoded or rewrapped files will be added to project media pool.

b. Add to Timeline. If checked, the transcoded or rewrapped files will also be added directly to the timeline.  New tracks named Imported Video and Imported Audio will be created and the files will be placed on those tracks.  If the project already contains media on the timeline, the new files will be added at the end of the project.

c. Add File Tag. If checked, a file tag will be added which is any text the user wants added to the name of the rewrapped or transcoded media file.  Two separate file tags are possible--one for Rewrapped media and another for Transcoded media.

8. Where to Save . There are three options.

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.

9. Start. Begins the rewrapping or transcoding process.

10. Cancel. Exits the script without processing.