OtterControl

OtterControl (OC) is an external app that enables the user to: (1) run Vegas scripts; (2) run Vegas keyboard shortcuts; (3) open file folders; and (4) launch external applications from a resizable and highly customizable GUI.  OC is launched from the OtterControl script that can be placed in either the Vegas script menu or one of the HOS menus including OtterBar, OtterInfoBar, or OtterMenu.  If placed in the Vegas script menu, it may be added to the top Vegas toolbar.

Quick-Start Guide

1. Launch OtterControl . You will see the default button layout with 6 rows by 20 columns.

 

2. Set Global Options    Click on Button 1 with the blue gear.

a. Set the number of rows and columns.

b. Set Hotkeys. 

(1) Restore Dialog.  Each time a button is pressed and an action executed, the dialog minimizes to the Windows taskbar.  The Restore Dialog hotkey restores the dialog to its last position.  Only a single key or a modifier key (Ctrl, Alt, Shift) plus a single key may be used.  These are global hotkeys.  Care must be taken so that the hotkey selected will not trigger other apps.

(2) Repeat Last Action.  This hotkey simply repeats the last action.

(3) ScriptExe Extension.  A hotkey is required to launch an extension that runs a selected script.  The default shown, Ctrl+1+1, is already set if the [HappyOtter] keyboard map is selected.  If not, you must add a global shortcut to your own  keyboard map that is the same as the shortcut shown in this textbox.

c. Click the OK button to exit the dialog.

3. Set Button Actions .  Right-clicking on a button launches the Button Design Options dialog.

a. Select a button action using radio buttons: (1) run a script; (2) run a keyboard shortcut; (3) go to a folder; or (4) launch an application.

b. Add a button image, button name and button description if desired.

c. Drag the mouse over the button to preview the tooltip that will be shown.

d. Click the OK button.

4. Execute Action.  Click on the button to execute the action.

Global Options

 

1. Select Template. OC enables the user to create multiple templates.

a. Available templates are shown in a a drop down list.

b.   To remove a template, first select the template from the dropdown list and then click the red X button.

c.   Opens the folder containing all templates.

d. Add New button creates a new blank template.  Enter name in dialog and click OK.

2. Set Controller Size.  Enter the number of rows and columns.  There are a maximum of 120 cells.

3. Select Button Colors

a. Load Defaults.  The default theme when first loaded is Vegas 15 Dark.  To change the default background and text colors, select the desired defaults using the radio buttons.  For a custom color, click on the Custom radio button and then choose the background and text colors as described in item b, click the All radio button  and click the Apply Now button under "Apply to Which buttons" and then click OK.

b. Color Selection.  Applies to both the selection of background and text colors.

(1)  Opens the color selection dialog.

(2) HTML Code.  Colors are expressed in HTML code.  As such, color codes can be directly entered (pasted) from other color selection tools such as ColorCop which is also included in the HOS tool set.

(3)   If color code is pasted into the HTML Code textbox, click on the green "check mark" button to apply the color.

(4) The selected background and text colors are shown in the solid Background and Text boxes.

c. Preview. A preview of the button background and text are shown in the solid Preview box.

4. Apply to Which Buttons

a. None. No color changes are applied.

b. All. Selected button color applied to all buttons.

c. Buttons. Selected button color applied to a range of buttons which may be entered in the two textboxes.  For example, to apply a color to all buttons on the second row, the user would enter 21 and 40 into the boxes.

d. Scripts. Selected button color applied to all buttons that execute a script.

e. Shortcuts. Selected button color applied to all buttons that execute a shortcut.

f. Folders. Selected button color applied to all buttons that open a folder.

g. Applications. Selected button color applied to all buttons that launch an application.

h. Apply Now. Click button to apply selected color to selected buttons.

5. What Text to Show.  Text to be displayed for each button.

a. Name Only.  Displays the user assigned name only.

b. Number Only. Displays button number only from 1 - 120.

c. Both. Displays both the button name and number.

d. None.  No text is shown.

6. Sort By. Two options are available.

a. Type by Name. Buttons are first sorted by type of action and then name within an action.

b. Name Only. Buttons are sorted by button name only.

7. Set Hotkeys.  Three hotkeys must be set. 

a. NOTE.  Once OC is launched, the two most important hotkeys are the Restore Dialog and Repeat Last Action as described below.  While a keyboard works, it is highly recommended that you use of a mouse with programmable buttons or something like the ShuttleProV2.

b.   Clears the current hotkey and enables entry of a new hotkey.  NOTE: Unlike normal hotkey entry (e.g. holding the Ctrl and Alt keys down while entering the F1 key) hotkeys are entered sequentially (press Ctrl, press Alt, press F1).  Holding a key down will result in multiple entries, thus requiring a reset.

c. Restore Dialog.  Global hotkey which restores the OC dialog.  Global hotkeys must consist of a single key (E.g. F9, the default) or a modifier key (Ctrl, Alt, Shift) plus a single key (E.g. Alt+F9).

d. Repeat Last Action.  Global hotkey which repeats the last executed action.  Global hotkeys must consist of a single key (E.g. F10, the default) or a modifier key (Ctrl, Alt, Shift) plus a single key (E.g. Alt+F10).

e. ScriptExe Extension .  Executing a script from OC requires the use an HOS extension ScriptExe which is already a part of the normal HOS installation.  To launch ScriptExe which in turn executes a script requires that a global keyboard shortcut in Vegas be defined.  As shown, the default is Ctrl+1+1.  A custom keyboard map, HappyOtter, is included in the normal HOS installation and already contains the required shortcut as shown.

Alternatively, the user may enter the above shortcut into any Keyboard map.  The user may also change the default shortcut itself in the Global Options dialog so long a the same keyboard shortcut is entered into the user's current keyboard map.

8. Cancel . Exits the dialog without making changes.

9. OK . Exits dialog and applies changes.

Button Design Options.  Right-clicking on a button opens the Button Design Options dialog.

1.   Resets the dialog to its default settings.

2. Button Preview.  Dragging mouse over the button displays the tooltips that will be shown--the name of the button and the specific run action.

3. Show Text.  Select the text to be displayed using radio button selections. 

4. Appearance

a. Button Color.  Both background and text color can be customized.  The defaults are those colors selected in the Global Options dialog for each option.  See section 3.b for a description of the color controls.

b. Use Default Colors.  If ticked, the default background and text color will be applied--e.g. the Vegas 15 dark theme colors.

c. Button Image File.  Enables the user to use a custom button icon.  The recommended format is png and pixel size 16x16.  Scripts will use the associated script icons.  Applications will use the default icon associated the exe file.  Icons for shortcuts and folders are  and  respectively.

d. Button Name. Name that appears on the button.

e. Button Description.  Description that is displayed in the tooltip shown when the mouse hovers over a button.

5. Actions.  The following radio buttons are used to select the type of action to be executed.

a. None.  The default--none selected.

b. Run Script.  The user may select scripts from drop down list which are included in the Vegas script menu folder.

(1) From File.  If ticked, the user may enter a script that is not found within the Vegas script menu folder--E.g. HOS tools that are found in the following folder for Magix versions "C:\ProgramData\HappyOtterScripts\Magix Vegas Pro\Scripts".  Clicking the search folder icon  launches the open file dialog.

c. Run Keyboard Shortcut.  If ticked, a Vegas keyboard shortcut may be entered.    clears the shortcut textbox.  Entering Vegas shortcuts is the same as entering hotkeys under Global Options., Unlike normal shortcut entry (e.g. holding the Ctrl and Alt keys down while entering the F1 key) hotkeys are entered sequentially (press Ctrl, press Alt, press F1). 

(1) Run Vegas Shortcuts.  If ticked, drop down lists are provided for both the category of shortcut and list of shortcuts within each category.  These are pretty much the same as found in the Vegas help file containing available shortcuts.  Note that the categories and shortcuts within each category were taken from Vegas 14.  While most are the same, the user should make sure they have not changed for later Vegas versions.

d. Go to Folder.  If ticked, the user may select a folder by clicking on the folder icon button  which launches the folder browse dialog.

e. Launch App.  If ticked, the user may select an application which will be launched when the button is clicked.  Clicking on the folder icon  launches the open file dialog.

6. Copy.  The contents of a button may be moved to a different button location.  To do so, click on the Copy button.  Then close the dialog and right-click on the target button location.

7. Paste. Click on the Paste button to copy the contents from the previous button to the current location.  Upon completion, a message box will appear asking whether to remove the copied contents from the previous location.

8. Cancel . Exits the dialog without making changes.

9. OK. Applies changes to the button and exits the dialog.