You can use scripts to automate tasks, or to provide functionality not directly available through UltraMon.

Scripts which manipulate the active (or foreground) window, for example move or maximize it, need to be run via hotkeys. To do this, go to UltraMon Options > Hotkeys, and add a new 'Run application or script' hotkey.

Other scripts can be run directly, or via UltraMon's Shortcuts menu. To run a script from UltraMon's Shortcuts menu, copy the script to your shortcuts folder. Go to Options > Profiles and Shortcuts for the location of this folder, or choose Shortcuts > Manage Shortcuts from the UltraMon menu to open the folder.

See the UltraMon Help for information on creating your own scripts.

Scripts for use with UltraMon

ActivateApp
Activates an application given the window caption. The first line of the script needs to be set to the window caption of the application you want to activate.

ApplyProfileAndMoveWinTbar
Applies a display profile and then moves the Windows taskbar to a specific monitor. The first 2 lines of the script specify the profile and monitor to be used. More information

ApplyProfileAndRestoreIcons
Applies a display profile and then restores the position of the desktop icons. The first 3 lines of the script need to be adjusted for your system (UltraMon installation directory, profile directory and profile name). More information

ApplyProfileAndWallpaperDockedUndocked
Applies a display profile and loads a wallpaper depending on whether the laptop is docked or not. You'll need to specify the display profiles and wallpapers that should be used on the first 4 lines of the script (full path and file name).

ApplyProfileDelayed
Applies a display profile after waiting a specified number of seconds. The first 2 lines of the script need to be adjusted (profile, delay).

CenteredMonitorPreviewLowPriority
Creates one or more fullscreen, centered, monitor preview windows running at a specified process priority (low by default). The first 6 lines of the script need to be adjusted for your needs.

CenterWnd
Centers the active window on the monitor it is on.

ChangeDesktop
Enables use of the Smart Taskbar on secondary virtual desktops if the virtual desktop hides the UltraMon taskbars. The script first switches to the next virtual desktop by sending a hotkey (the virtual desktop manager needs to support switching desktops via hotkeys), then shows the hidden UltraMon taskbars. Run the script for more information on configuring it. More information

ChangeWallpaper
Loads the next UltraMon wallpaper if you have created multiple UltraMon wallpapers. Line 3 needs to be adjusted for your system. More information

ChangeWallpaper2
Loads the next UltraMon wallpaper if you have created multiple UltraMon wallpapers, also works with UltraMon 3.

ChangeWallpaperAuto
Loads the next UltraMon wallpaper at a fixed interval if you have created multiple UltraMon wallpapers. Line 3 and 4 may need to be adjusted for your system. By default the wallpaper will get changed every hour. The only way to stop the script is to terminate the script host process, wscript.exe, via Task Manager.

ChangeWallpaperAuto2
Same as ChangeWallpaperAuto, but with support for UltraMon 3.

DisableEnableMonitor
Prompts for a monitor number then disables or enables the monitor.

DisableEnableMonitorX
Disables or enables a specified monitor. Set the monitor number on line 9 of the script.

DisableEnableScreenSaver
Disables or enables the screen saver.

DisableEnableSecondaryInd
Disables or enables secondary monitors one by one, instead of all at once. This is a workaround for systems where disabling/enabling multiple monitors at once doesn't work. More information

DisableEnableSecondaryNoIconSave
Disables or enables secondary monitors, but doesn't save the position of desktop icons before disabling secondary monitors.

DisableEnableSecondaryNoWndSave
Disables or enables secondary monitors, but doesn't save/restore the position of open windows.

EnableSecondaryAndChangePrimary
Enables the secondary monitors, waits for a specified number of seconds, then sets a new monitor as primary. You'll need to edit the first two lines of the script. More information

ExecuteHotkey
Executes a hotkey, optionally after a specified delay. You'll need to edit the first two lines of the script. More information

ExplorerOnMonitorX
Opens a new Windows Explorer window on a specified monitor. You'll need to adjust lines 2-4 for your needs. More information

FitBottomHalf
Fits the foreground window to the bottom half of the monitor it is on.

FitLeftHalf
Fits the foreground window to the left half of the monitor it is on.

FitRightHalf
Fits the foreground window to the right half of the monitor it is on.

FitTopHalf
Fits the foreground window to the top half of the monitor it is on. More information

IeDesktopMaximized
Opens a website maximized across the desktop in fullscreen mode in Internet Explorer. You'll need to set the first line of the script to the website you want to display. More information

LaunchApp
Launches an application then moves it to the specified monitor. Run the script for usage instructions.

LaunchShortcutsDelayed
Launches one or more UltraMon shortcuts after a specified delay. You'll need to edit the first 3 lines of the script.

LaunchVideo
Takes a single argument, the video file, then starts the specified video player and moves the window to the specified position. You'll need to adjust the first 3 lines of the script. More information

Maximize2Mon
Maximizes the foreground window across two specified monitors instead of the whole desktop. Only useful for systems with more than 2 monitors. You'll need to adjust the first 2 lines of the script for your needs.

MaximizeVertically
Maximizes the foreground window only vertically, instead of both vertically and horizontally. Please note that you won't be able to restore the window to its original size using the restore button after it has been maximized vertically. More information

MinimizeWnd
Minimizes the foreground window.

MirrorWnd
Mirrors a window on another monitor using the MirrorMon add-on for UltraMon. The window is identified by its title. Edit the first four lines of the script to configure it for your needs.

MonInfo
Displays information about installed monitors.

MoveActiveWnd
Moves the active window to the specified monitor (passed as a command-line argument). More information

MoveActiveWndNextMon
Moves the active window to the next monitor. More information

MoveAndMaximizeWnd
Moves the active window to the next monitor and maximizes it.

MoveSecondaryMonitorLeftOrRight
Toggles the position of the secondary monitor between left-of-the-primary and right-of-the-primary. Doesn't work on systems with more than 2 monitors. More information

MoveWinamp2
Moves Winamp version 2 (all windows) to a specific position. Set the position on lines 7 and 8 of the script.

MoveWinTbar
Moves the main taskbar to a specific monitor, optionally after waiting for a specified number of seconds. You'll need to configure the first two lines of the script. Please note that UltraMon may not always be able to move the main taskbar.

MultiBrowser
Opens multiple websites, one on each monitor. Lines 4-7 of the script need to be adjusted. More information

MultiBrowser2
Opens multiple websites, one on each monitor, in IE fullscreen. Lines 1-3 of the script need to be adjusted. More information

MultiBrowser3
Same as MultiBrowser2, but with support for Internet Explorer version 7.

NewMail
Opens a new blank e-mail.

OpenDocOnMonX
Opens a document or Internet shortcut (.url file) on a specified monitor, see the script for required command-line arguments. Line 6 can be changed if Internet shortcuts should be opened in a browser other than Internet Explorer. More information

OpenGwk
Disables secondary monitors, opens the .gwk file passed on the command line in GC-Prevue, then re-enables secondary monitors. You'll need to set the location of gcprevue.exe on the first line of the script. More information

ReloadWallpaper
Reloads the current UltraMon wallpaper by deleting the wallpaper bitmap generated by UltraMon, then regenerating it. To reload a specific UltraMon wallpaper, pass the full path and file name of the wallpaper to the script, for example:

ReloadWallpaper.vbs "C:\Temp\My UltraMon wallpaper.wallpaper"

If UltraMon wasn't installed in the default location, you'll need to adjust the first line of the script.

RestartSmartTaskbar
Restarts the Smart Taskbar.

RestoreDesktopItems
Restores the position of desktop icons and Active Desktop items. Positions can be saved with SaveDesktopItems. More information

RestoreWndPos
Restores the position of open windows. Positions can be saved with SaveWndPos. More information

RunMirrorConfig
Stops mirroring, then loads the mirroring configuration specified on the command line, and starts mirroring again. The first line of the script needs to be adjusted for your system. More information

SaveDesktopItems
Saves the position of desktop icons and Active Desktop items. Positions can be restored with RestoreDesktopItems. More information

SaveWndPos
Saves the position of open windows. Positions can be restored with RestoreWndPos. More information

ShowDesktop
Shows or hides the desktop. Does the same thing as the Show Desktop command, or the WIN+D hotkey.

SingleMonStopTbar
Stops the Smart Taskbar if only a single monitor is enabled. More information

SwitchPrimary
Sets the next monitor (in numerical order) as the primary monitor. Only works on Windows 2000/XP or later.

SysInfo
Displays system information such as the number of monitors and their settings.

ToggleMirroring
Toggles mirroring on or off. The first line of the script needs to be adjusted for your system if you didn't install UltraMon in the default location.

ToggleMirroring2
Same as ToggleMirroring, but with support for UltraMon 3.0.3 and later.

ToggleSecondaryAndPrimary
Toggles the secondary monitor between enabled/primary and disabled. The first two lines of the script may need to be adjusted for your system. More information

ToggleSingleMon
Enables the disabled secondary monitor, sets it as primary, then disables the old primary monitor. Only works correctly on systems with no more than two monitors. More information

ToggleSmartTaskbarMode
Toggles the Smart Taskbar between standard and mirror mode. The Smart Taskbar gets stopped before changing the mode, and restarted afterwards. The first line of the script needs to be adjusted for your system. More information

ToggleVideoOverlays
Shows if video overlays are currently enabled or disabled, and allows you to disable or enable them. The script actually disables or enables DirectDraw acceleration, which also disables/enables video overlays.

UltraMon Wallpaper Auto Changer
Changes the desktop wallpaper at a set interval using images from a specified folder. See the script for detailed instructions. More information

UltraMon Wallpaper Auto Changer 2
Same as the UltraMon Wallpaper Auto Changer script, but with support for UltraMon 3. More information

VMonMaximizeWnd and VMonMoveWnd
Allows you to split monitors into two or more virtual monitors, then maximize and move windows to/between these virtual monitors. See the script for detailed instructions. More information

VMonMaximizeWnd2 and VMonMoveWnd2
Same as VMonMaximizeWnd/VMonMoveWnd, but the splits don't need to be even. For example you could split a monitor in two halves, with the left half being 75% wide, the right half 25%. See the script for detailed instructions. More information

VMonMaximizeWnd3 and VMonMoveWnd3
Same as VMonMaximizeWnd2/VMonMoveWnd2, but monitors can be partitioned arbitrarily. For example you could split a monitor in left and right halves, then split the right half in a top and bottom half. See the script for detailed instructions. More information