• Fixed bug: elevate and other commands failed to work properly when there were many parameters after the command.

• The runinteractive and runinteractivecmd commands now work properly even if you don't run them from a Windows service.
• Fixed bug: The behvaiour of consolewrite command was unexpected when there was '%' character.

• Fixed to work again on Windows 98/2000.

• Added runinteractive and runinteractivecmd commands, which allows you to run a process or NirCmd command that accesses the GUI from a Windows service.
• For example, if you try to use the savescreenshot command from a Windows service, you'll get a black image, because NirCmd cannot access the user interface from a Windows service.
• You can solve this problem with runinteractivecmd command: nircmd.exe runinteractivecmd savescreenshot "c:\temp\screenshot1.png"
• Be aware that runinteractive and runinteractivecmd commands only work from a Windows service ('SYSTEM' user).

• Fixed the savescreenshot or savescreenshotfull commands to work properly with DPI scaling.

• Fixed bug: NirCmd failed to execute the cmdwait, loop and a few other commands after qboxcom and qboxcomtop commands.

• Fixed bug: clipboard readfile failed to read the last character of Ascii file.
• Added writeufile and addufile to clipboard command, for writing files in Unicode.
• Fixed the restartexplorer command to work properly on Windows 10.

• Added new commands: moverecyclebin, suspendprocess , resumeprocess.
• Added etitle option to the find parameter of win command.
• 'clipboard readfile' command now reads Unicode files (UTF-8 and UTF-16).

• Added runassystem command, which allows you to run a process with SYSTEM user (Works on Windows 7/8/Vista/2008)

• Added new option to speak command: You can now save the entire speach into a .wav file that can be played with any media player (Instead of playing it directly to your sound card).
• Added restartexplorer command, which simply restarts Windows Explorer gracefully.
• Added screensavertimeout command, which allows you to set the screensaver timeout, in seconds.
• Added togglemax, togglemin, togglehide, toggledisable actions to win command.
• Added SystemSounds support for setappvolume, changeappvolume, and muteappvolume commands.
• Fixed issue on Windows 7: 'win close alltopnodesktop' command caused a shutdown dialog-box to appear.
• Fixed the setprimarydisplay to work properly.

• Added setdefaultsounddevice command (for Windows 7/Vista/2008 only), which allows you to set the default sound device.
• Added setsubunitvolumedb command (for Windows 7/Vista/2008 only), which allows you to set the volume of sound device subunits (Line In, Microphone, and so on)
• Added mutesubunitvolume command (for Windows 7/Vista/2008 only), which allows you to mute/unmute the volume of sound device subunits (Line In, Microphone, and so on)

• Added mediaplay command for playing audio file (.mp3, .wav, and so on) for the specified number of milliseconds.
• Added changebrightness and setbrightness commands for setting the screen brightness on laptops and netbook computers.

• On savescreenshot, savescreenshotfull, and savescreenshotwin commands, you can now specify *clipboard* as a filename, in order to save the screenshow into the clipboard
• On savescreenshot command, you can now specify a rectangle to capture as x, y, width, and height instead of capturing the entire screen.
• Fixed savescreenshotfull command to work properly on multiple screen system with negative coordinates.

• Added 'runas' command, which allows you to run a new process with the specified user name/password.
• Added 'Flash' action to the win command, with allows you to flash the specified window.

• Added 'focused' option for setappvolume, changeappvolume, and muteappvolume commands, which allow you to easily change the volume of the application that is currently in focus, on Windows 7/Vista/2008.
• Added 'default_record' option for setsysvolume, changesysvolume, setsysvolume2, changesysvolume2, and mutesysvolume commands, which allows you set easily change the volume of default recording device, on Windows 7/Vista/2008.

• Added 3 new sound volume commands to change or mute application volume on Windows 7/Vista/2008: setappvolume, changeappvolume, muteappvolume
• Added new information command that shows you a message box with all sound devices on your Windows 7/Vista/2008 system: showsounddevices.

• Fixed the problems with the timeout of the tray balloon in trayballoon command.

• Fixed bug: The sendkeypress command didn't work properly with Fxx keys (F1, F2, and so on).

• Added option to locate window by process in win command.
• Added max and min options (Minimized and maximized windows) into exec and exec2 commands.
• Added x64 builds of nircmd.exe and nircmdc.exe

• Added trayballoon command - displays a tray balloon with your desired text and icon.
• Added sendkeypress command - Alternative to the sendkey command. Allows you to send key press combination in much easier way, for example: sendkeypress ctrl+shift+esc
• Added clonefiletime command to clone the date/time of existing file into one or more files.
• Added setconsolemode command to set the console display mode - window or full screen.
• Added setconsolecolor command to set the foreground and background colors of the console text.
• Added consolewrite command to write text into the console window.
• Added debugwrite for writing text into the debug output.
• Added ~$folder.mydocuments$ variable.

• Fixed a bug in elevate command: when running a program without parameters, NirCmd sent the elevate command string as a parameter of the program.

• Added elevate and elevatecmd commands to run and execute commands with administrator rights under Windows 7/Vista/2008.
• Added monitor parameter to setdisplay command, for using it with multiple monitors.
• Added setprimarydisplay command.
• Added folder.programfiles and folder.common_programfiles variables.
• Added async_off, async_on, async_low for monitor command. You can try them if NirCmd.exe remains in memory when you use monitor on/off command.

• Improved the help .chm file - Now it contains a link to every command.
• Added help command - Automatically opens the reference of the desired command in http://nircmd.nirsoft.net. For example, if you type 'nircmd.exe help speak', the reference page of speak command - http://nircmd.nirsoft.net/speak.html will be opened in your default browser.

• Fixed bug in script: Sometimes the last line in the script was not executed properly.

• Added loop command - execute a command multiple times.
• Added currtime and currdate variables.
• waitprocess - Added option to execute a NirCmd command after the process was closed.
• Added rem (or ;) command, just for adding remarks in a script.

• Added speak command - Speaks the contents of the text or file that you specify, by using the Speech library (SAPI) that comes with Windows XP and Windows Vista.
• Added savescreenshotfull command.

• New actions for clipboard command - loadclp and saveclp (load/save in Windows .clp format)
• New command: setprocessaffinity

• New commands: waitprocess, setprocesspriority, qboxtop, qboxcomtop.
• New action in clipboard command: copyimage (Copy image file to the clipboard)

• New commands: setcursorwin, savescreenshotwin, filldelete

• New commands: shellcopy, savescreenshot

• New commands: shellrefresh, convertimage, convertimages
• New option in clipboard command - saveimage

• All sound volume commands and monitor command now works under Vista.
• New commands: dlg, dlgany, sendkey, sendmouse, returnval
• New actions in win command - dlgclick, dlgsettext, dlgsetfocus

• New command: cmdshortcutkey

• Starting from this version, if you don't specify a sound device index in setsysvolume, changesysvolume, setsysvolume2, changesysvolume2 and mutesysvolume commands, the default sound device in control panel ("preferred device") is used.
• New find options in win command: active, foreground, desktop

• Fixed bug with parameter variables: parameter dialog-box appear more than once.
• New find option in Win command: alltopnodesktop

• New win actions: postmsg and sendmsg.
• New command: closeprocess
• NirCmd now returns a non-zero value on error.

• New command: emptybin - Empty the Recycle Bin.
• New optional parameter in setdisplay command: refresh rate.
• rashangup command without parameter - disconnect all active connections.

• New commands: exec2, cmdwait.
• New options in clipboard command.
• Volume commands (setsysvolume, changesysvolume, setsysvolume2, changesysvolume2, mutesysvolume) now allows you to change the volume of non-default sound card.

• New win actions: activate, hideshow, +style, -style, +exstyle, -exstyle
• New commands: movecursor, setcursor.
• New command: setfilefoldertime - allows you to change the date/time of folders, under Windows 2000/XP only.

• New actions in win command: focus, enable, disable

• new command: sysrefresh - make a general system refresh after modifying your system settings in the Registry.

• New paramsfile command: Allows you to execute a command multiple times by loading the parameters from a text file.
• New actions in win command: move, center, settext.
• New 'child' action in win command: Allows you to move/hide child windows (For example: the start button in the system tray)
• New clipboard command: Allows you to put a string in the clipboard, and clear the clipboard.
• New gac command: Allows you to install assemblies in Global Assembly Cache.

• New variable: ~$clipboard$ - paste the text that you copied to the clipboard into the command-line.
• Parameter variables: ~$param.ParamName$ - Display an input window for typing the text that you want insert into the command-line.

• On reg commands (regsetval, regdelval, regdelkey), you can now also use the following abbreviated key name: HKCU for HKEY_CURRENT_USER, HKLM for HKEY_LOCAL_MACHINE, HKCR for HKEY_CLASSES_ROOT, HKU for HKEY_USERS, HKCC for HKEY_CURRENT_CONFIG.
• redraw action for win command.

• New commands: cmdshortcut, regsvr, mutesysvolume, changesysvolume, changesysvolume2, setsysvolume2.
• New actions in win command: trans, setsize, settopmost, ititle.
• New variables: folder.nircmd, nir.exefile
• nircmdc.exe - console version of NirCmd.
• Changed name - from NirComLime to NirCmd.

• New commands: wait, setvolume, setsysvolume, execmd, exec.
• New commands for executing NirCmd on remote machines: remote and multiremote.
• Folder and system variables.
• New option in setfiletime command - set the file time to the current time (now parameter)
• New parameter in shortcut command - hot key.

• New commands: qboxcom, beep, stdbeep, cdrom, urlshortcut, monitor, screensaver, standby, and hibernate.
• Fixed the bug with ~x string sequences.

• New commands: setdialuplogon, script
• Special string sequences (~q, ~t, ~n and so on) to allow you to embed quotes and new line characters into the parameters of any command.

remote {copy} [\\computer] [NirCmd command]

multiremote {copy} [computers file] [NirCmd command]

\\comp1
\\comp2
\\winxp1
\\winxp2
\\nirsoft

• Turn off all computers specified in computers.txt
  multiremote "c:\temp\computers.txt" exitwin poweroff force
• Lock all computers specified in computers.txt
  multiremote "c:\temp\computers.txt" lockws
• Copy NirCmd to all computers specified in computers.txt, and then turn off their monitors.
  multiremote copy "c:\temp\computers.txt" monitor off
• Copy NirCmd to all computers specified in computers.txt, and run WinUpdatesList utility in order to save Windsows Updates info in all computers.
  multiremote copy "c:\temp\computers.txt" exec hide c:\temp\wul.exe /shtml "c:\temp\wul_~$sys.computername$.html"

cmdwait [Number of Milliseconds] [NirCmd Command]

Example:
cmdwait 1000 monitor async_off

loop [Number of Times] [Number of Milliseconds] [NirCmd Command]

Examples:
loop 3 2000 speak text "Call Number ~$loopcount$"
loop 10 60000 savescreenshot c:\temp\scr~$loopcount$.png

paramsfile [Parameters File] [Delimiters] [Quote Character] [NirCmd Command]

Here's an example... Let's say that you have the following text file, containing user names and passwords, delimited by comma:

user01, 123456
user02, abcfg
user03, 5fr23
user04, 33333

The following NirCmd commands sequence will create 4 users with the specified user-names and passwords (by using 'net user' command provided by Windows 2000/XP operating system)
nircmd.exe paramsfile "c:\temp\users.txt" "," "" execmd net user ~$fparam.1$ ~$fparam.2$ /add

The ~$fparam.1$ specifies the first entry in each line - the user name. The ~$fparam.2$ specifies the second entry in each line - the password.

Examples:

paramsfile "c:\temp\folders.txt" "" "" execmd md ~$fparam.1$
paramsfile "c:\temp\shortcuts.txt" "," "~q" shortcut ~$fparam.1$ "~$folder.desktop$" ~$fparam.2$

infobox [message text] [title]

qbox [message text] [title] [program to run]

qboxtop [message text] [title] [program to run]

qboxcom [message text] [title] [NirCmd Command]

qboxcomtop [message text] [title] [NirCmd Command]

script [Script File]

infobox "Hello !" "This is the first message"
infobox "Hello !" "This is the second message"
infobox "Hello !" "This is the third message"

regedit [key] [value name]

regsetval [type] [key] [value name] [value]

regdelval [key] [value]

regdelkey [key]

inisetval [INI filename] [section] [key] [value]

inidelval [INI filename] [section] [key]

inidelsec [INI filename] [section]

regsvr [reg or unreg] [filename or wildcard] {log file}

rasdial [Entry Name] {Phonebook File} {User Name} {Password} {Domain}

inetdial [Entry Name]

rasdialdlg [Entry Name] {Phonebook File} {Phone Number or IP Address}

rashangup {Entry Name}

setdialuplogon [Entry Name] [User Name] {Password} {Domain} {Phonebook File}

• [Entry Name]: The name of the dial-up entry
• [User Name]: The user-name to set into the specified dial-up entry.
• {Password}: The password to set into the specified dial-up entry.
• {Domain}: The domain name to set into the specified dial-up entry.
• {Phonebook File}: The phonebook file containing the entry you want to change. If you don't specify this parameter, the default phonebook is used.

exitwin [shutdown type] {additional option}

• logoff: Shut down all running processes, log off the current user, and display the log on dialog to allow another user to log into the system.
• reboot: Shut down the entire system, and then reboot.
• poweroff: Shut down the entire system, and then turn off the power. (Only for systems that support this feature !)
• shutdown: Simply shut down the entire system, without reboot and without turning the power off.

• force: Forces all applications to terminate immediately. Using this option can caused the current running application to lose data. Use it only in extreme cases !
• forceifhung: Forces applications to terminate if they are not responding. This option is only available in Windows 2000/XP.

initshutdown {message} {timeout value in seconds} {force} {reboot}

• {message}: The message to display before starting the system shut down.
• {timeout value in seconds}: The number of seconds to wait before starting the system shut down.
• {force}: Forces all applications to terminate, even without saving your work.
• {reboot}: Reboot after the system shutdown.

abortshutdown

lockws

monitor [action]

• off: Turn off the monitor
• async_off: Turn off the monitor. Use this value if NirCmd remains in memory when using monitor off.
• on: Turn on the monitor
• low: Set the monitor to low power state.

screensaver

screensavertimeout [Timeout]

standby {force}

hibernate {force}

shortcut [filename] [folder] [shortcut title] {arguments} {icon file} {icon resource number} {ShowCmd} {Start In Folder} {Hot Key}

• [filename]: Create a shortcut to this filename.
• [folder]: Specify the destination folder that inside it the shortcut will be created. You can specify any valid folder, including the special variables that represent system folders, like ~$folder.desktop$ (Desktop folder), ~$folder.programs$ (Start-Menu-Programs folder), and so on...
• [shortcut title]: The text displayed in the shortcut.
• {arguments}: Optional parameter - Additional arguments to execute the filename.
• {icon file}: Optional parameter - Use this parameter if your want that the shortcut will be displayed with icon other than the default one.
• {icon resource number}: Optional parameter - The resource number inside the icon file.
• {ShowCmd}: Optional parameter - Use this parameter if you want to maximize or minimize the window of the program. Specify "max" to maximize the window or "min" to minimize it.
• {Start In Folder}: Optional parameter - Specifies the "Start In" folder. If you don't specify this parameter, the "Start In" folder is automatically filled with the folder of the program you specify in [filename] parameter.
• {Hot Key}: Optional parameter - Specifies an hot-key that will activate the shortcut. For example: Alt+Ctrl+A, Alt+Shift+F8, Alt+Ctrl+Shift+Y

cmdshortcut [folder] [shortcut title] [command]

cmdshortcutkey [folder] [shortcut title] [hot key] [command]

urlshortcut [URL] [Folder] [Shortcut Title]

exec [show/hide/min/max] [application + command-line]

exec2 [show/hide/min/max] [working folder] [application + command-line]

execmd [command]

shexec [operation] [filename]

setfiletime [filename or wildcard] [Created Date] {Modified Date} {Accessed Date}

setfilefoldertime [filename, folder or wildcard] [Created Date] {Modified Date} {Accessed Date}

clonefiletime [source filename] [Wildcard]

moverecyclebin [Wildcard]

Warning !!
When using wildcards, this command also moves subfolders into the Recycle Bin, so use it very carefully !

Example:
moverecyclebin f:\temp\myfile.txt
moverecyclebin f:\temp\1\*.txt

emptybin {drive}

setdisplay {monitor:index/name} [width] [height] [color bits] {refresh rate} {-updatereg} {-allusers}

setprimarydisplay [Monitor index/name]

setbrightness [level] {mode}

changebrightness [level] {mode}

killprocess [process]

closeprocess [process]

In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
Examples:
closeprocess iexplore.exe
closeprocess "c:\winnt\system32\calc.exe"
closeprocess /1830

restartexplorer

waitprocess [process] {Command}

In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
Optionally, you can also specify a command to execute after the process was closed.
Examples:
waitprocess iexplore.exe
waitprocess firefox.exe speak text "Firefox was closed"
waitprocess "c:\winnt\system32\calc.exe"
waitprocess /1830

suspendprocess [process]

In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
Examples:
suspendprocess myprocess.exe
suspendprocess "c:\winnt\system32\calc.exe"
suspendprocess /1130

resumeprocess [process]

In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
Examples:
resumeprocess myprocess.exe
resumeprocess "c:\winnt\system32\calc.exe"
resumeprocess /1250

setprocesspriority [process] [priority]

In the [priority] parameter, you can specify one of the following values: normal, low, belownormal, abovenormal, high, realtime.
In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
Examples:
setprocesspriority iexplore.exe high
setprocesspriority "c:\winnt\system32\calc.exe" low
setprocesspriority /1830 abovenormal

setprocessaffinity [process] [list of processor numbers]

In the [process] parameter, you can specify the full path of the process filename (e.g: 'C:\Program Files\Internet Explorer\iexplore.exe') or the name of the process only, without the path (e.g.: iexplore.exe). You can also specify the Process ID, by adding the '/' character as a prefix (e.g. /1120).
In the [list of processor numbers] parameter, you can specify the processor numbers that you want to use. 0 is the first processor, 1 is the second one, and so on.
Examples:
setprocessaffinity iexplore.exe 0 1
setprocessaffinity "c:\winnt\system32\calc.exe" 0 1 2 3
setprocessaffinity /1830 0

memdump [process] [dump file] [bytes per line] {bytes to read} {start address} {nohex} {noascii}

• [process]: The process that you want to dump its memory. You can specify the full path of the process filename, the process name only, or the Process ID - by adding the '/' chararcter as prefix (e.g.: /520)
• [dump file]: The filename to save the memory content of the specified process.
• [bytes per line]: Number of memory bytes per line in the saved dump file.
• {bytes to read}: Number of bytes to read.
• {start address}: Start the dumping process from this memory address.
• {nohex}: Optional. If you specify this parameter, the memory data won't be saved in Hexadecimal format.
• {noascii}: Optional. If you specify this parameter, the memory data won't be saved in Ascii format.

service {\\Computer} [action] [service name]

• {\\Computer}: Optional. Specifies the name of the remote computer. If you omit this parameter, the local computer is used.
• [action]: The action you want to do. This parameter may contain one of the following values:
  • start: Starts the specified service or driver.
  • stop: Stops the specified service or driver.
  • pause: Pauses the specified service or driver.
  • continue: Continues the specified service or driver.
  • restart: Stops and then starts again the specified service or driver.
  • auto: Changes the startup type of the specified service or driver to Automatic.
  • manual: Changes the startup type of the specified service or driver to Manual.
  • disabled: Changes the startup type of the specified service or driver to Disabled.
  • boot: (Only for drivers) Changes the startup type of the specified driver to 'Boot'.
  • system: (Only for drivers) Changes the startup type of the specified driver to 'System'.
• [service name]: The name of the service or driver.

win [action] [find] [window to find] [Additional Parameters]

win child [find] [top window to find] [action] [find] [child window to find] [Additional Parameters]

• [action]: The action you want to do on the specified window:
  • child: Allows you to make an action on child window of the specified top-level window.
  • close: Closes the specified windows.
  • hide: Hides the specified windows.
  • show: Shows again the specified windows. (after hiding it with 'hide' command)
  • hideshow: Hides the specified windows and then shows it again. You can use this action to repaint the content of a window.
  • togglehide: Toggles the specified windows between visible and hidden state.
  • activate: Bring the specified window to the front.
  • flash: Flashes the specified window. the values in [Additional Parameters] specifies the number of flashes (the default is 5) and the number of milliseconds of every flash.
  • max: Maximizes the specified windows.
  • min: Minimizes the specified windows.
  • normal: Restores the specified windows to normal state, after minimizing or maximizing them.
  • togglemin: Toggles the specified windows between minimized and normal state.
  • togglemax: Toggles the specified windows between maximized and normal state.
  • trans: Make the specified windows transparent. the value in [Additional Parameters] is a number between 0 and 255 that specifies the transparency level. 0 = completely transparent. 255 = completely opaque.
  • setsize: Set the size of the specified windows. the values in [Additional Parameters] specifies the desired window size - x, y, width, height.
  • move: move/resize the window. the values in [Additional Parameters] specifies the number of pixels to move/change: x, y, width, height.
  • center: Center the specified windows.
  • settopmost:Set the top-most state of the specified windows. If the value in [Additional Parameters] is 1, the specified windows will become top-most windows, if the value is 0, the top-most state will be canceled.
  • redraw: Redraw the specified windows.
  • settext: Modify the caption/title of the specified windows.
  • focus: Set the focus to the specified window.
  • disable: Disable the specified window.
  • enable: Enable the specified window.
  • toggledisable: Toggles the specified windows between disabled and enabled state.
  • +style: Add style bits to the specified window. The value of [Additional Parameters] specifies the style bits to add.
  • -style: Remove style bits from the specified window. The value of [Additional Parameters] specifies the style bits to remove.
  • +exstyle: Add extended style bits to the specified window. The value of [Additional Parameters] specifies the extended style bits to add.
  • -exstyle: Remove extended style bits from the specified window. The value of [Additional Parameters] specifies the extended style bits to remove.
  • postmsg: Post a message to the specified window. The 3 values in [Additional Parameters] specifies the message parameters: Msg, wParam, lParam.
  • sendmsg: Send a message to the specified window. The 3 values in [Additional Parameters] specifies the message parameters: Msg, wParam, lParam.
  • dlgclick: Send a click command to the button inside a dialog-box. The value in [Additional Parameters] should specify the control ID of the button, or one of the following predefined buttons: yes, no, ok, cancel, retry, ignore, close, help.
  • dlgsettext: Set the text to the specified control inside a dialog-box. The value in [Additional Parameters] should specify the control ID.
  • dlgsetfocus: Set the focus to the specified control inside a dialog-box. The value in [Additional Parameters] should specify the control ID
• [find]: The method to find the window
  • handle: Finds the desired window by specifying the handle of the window in [window to find] parameter.
  • id: Finds the desired child window by specifying the id of the child window. Useful only for child windows.
  • class: Finds the desired window by specifying the class name of the window in [window to find] parameter.
  • title: Finds the desired window by specifying the exact title of the window in [window to find] parameter.
  • stitle: Finds the desired window by specifying the first few characters of the window in [window to find] parameter.
  • ititle: Finds the desired window by specifying a sequence of characters that exists in the window title.
  • etitle: Finds the desired window by specifying the last few characters of the window in [window to find] parameter.
  • alltop: All top windows.
  • alltopnodesktop: All top windows, except of desktop and tray windows.
  • active: The current active window.
  • foreground: The window in foreground.
  • desktop: The desktop window
  • process:Finds the desired window by specifying process ID (for example: /3412) or process name (for example: firefox.exe).
• [window to find]: Specifies the window by handle, class name, or title, according to the value of the previous parameter.

cdrom [action] {drive:}

clipboard [Action] [Parameter]

[Action] may contain one of the following values:

• set - set the specified text into the clipboard.
• readfile - set the content of the specified text file into the clipboard.
• clear - clear the clipboard.
• writefile - write the content of the clipboard to a file. (text only)
• writeufile - write the content of the clipboard to a Unicode file. (text only)
• addfile - add the content of the clipboard to a file. (text only)
• addufile - add the content of the clipboard to a Unicode file. (text only)
• saveimage - Save the current image in the clipboard into a file.
• copyimage - Copy the content of the specified image file to the clipboard.
• saveclp - Save the current clipboard data into Windows .clp file.
• loadclp - Load Windows .clp file into the clipboard.

gac [Action] [Parameter]

beep [Frequency] [Duration]

stdbeep

setvolume [device] [left-volume] [right-volume]

setsysvolume [volume] {Component} {Device Index}

Vista Examples:
setsysvolume 0x8000
setsysvolume 0 "front mic"
setsysvolume 25000 speakers
setsysvolume 25000 "line in"
setsysvolume 25000 default_record

setsysvolume2 [left volume] [right volume] {Component} {Device Index}

changesysvolume [volume change] {Component} {Device Index}

Vista Examples:
changesysvolume 5000
changesysvolume -3000
changesysvolume 0x1000 "line in"
changesysvolume 0x1000 "speakers" 1
changesysvolume 0x1000 default_record

changesysvolume2 [left volume change] [right volume change] {Component} {Device Index}

mutesysvolume [action] {Component} {Device Index}

Vista Examples:
mutesysvolume 1
mutesysvolume 0
mutesysvolume 2 "rear mic"
mutesysvolume 1 speakers 1
mutesysvolume 1 default_record

setappvolume [Process] [volume level] {Device Name/Index}

changeappvolume [Process] [volume level] {Device Name/Index}

muteappvolume [Process] [mute mode] {Device Name/Index}

setdefaultsounddevice [Device Name] {Role}

setsubunitvolumedb [Device Name] [Subunit Name] [Decibel Value]

mutesubunitvolume [Device Name] [Subunit Name] [mute mode]

showsounddevices

wait [milliseconds]

shellrefresh

sysrefresh {Refresh Type}

setcursor [X] [Y]

setcursorwin [X] [Y]

movecursor [X] [Y]

dlg [Process Name] [Window Title] [Action] [Parameters]

The following command will choose the 'Yes' answer for any question dialog-box of Explorer process:
dlg "explorer.exe" "" click yes

The following command will choose the 'Cancel' answer for any question dialog-box of any process:
dlg "" "" click cancel

Parameters description:

• [Process Name]: Specifies the process that created the desired window. You can specify only the process name or the full path of the process. If this parameter is empty string("" ), the command will be executed on any process.
• [Window Title]: Specifies the title of the window that you want the execute the action. If this parameter is empty string("" ), the command will be executed on any window, regardless the window title.
• [Action]: You can specify one of the following options:
  • click: Click the specified button. You can specify one of the following predefined values (For standard Windows dialog-boxes only !): yes, no, ok, cancel, retry, ignore, close, help. You can also specify any control ID as numeric value.
  • settext: Set the text of the specified control. The first parameter of this action specifies the ID of the control, and the second parameter specifies the text.

dlgany [Process Name] [Window Title] [Action] [Parameters]

returnval [Return Value]

sendkeypress [Keys Combination 1] [Keys Combination 2] [Keys Combination 3] ...

You can specify more than one [Key Combination] in a single sendkeypress command.

Here's some examples for using sendkeypress:

• Send ctrl+shift+esc to show the task manager of Windows:
  sendkeypress ctrl+shift+esc
• Send ctrl+shift+esc to show the task manager of Windows and then move to the next window with alt+tab:
  sendkeypress ctrl+shift+esc alt+tab
• Switch the capslock mode:
  sendkeypress capslock
• Print 'Nir Sofer' to the current text editor in focus (The shift key combination is used to get the capital letters):
  sendkeypress Shift+n i r spc shift+s o f e r
• Save the current screen image into the clipboard (Ctrl+PrintScreen):
  sendkeypress Ctrl+printscreen
• Send Ctrl+Shift+K and then Ctrl+Shift+A and then Alt+Shift+P:
  sendkeypress ctrl+shift+k ctrl+shift+a alt+shift+p

sendkey [Key] [press | down | up]

In the following script example, the system behaves like the user presses Shift+Ctrl+Esc (the task manager should appear):
sendkey shift down
sendkey ctrl down
sendkey esc down
sendkey shift up
sendkey ctrl up
sendkey esc up

More examples:
sendkey a press
sendkey f10 press
sendkey enter press
sendkey 0x2e press

sendmouse [right | left | middle] [down | up | click | dblclick]

sendmouse [move] [x] [y]

sendmouse [wheel] [Wheel Value]

• Sent a right click (For most applications, a context menu is opened):
  sendmouse right click
• Sent a double-click with the left mouse button:
  sendmouse left dblclick
• Press the left mouse button, move the mouse cursor 30 pixels left and 20 pixels down, and then release the button:
  sendmouse left down
  sendmouse move -30 20
  sendmouse left up
• Scroll the mouse wheel 10 units in standard wheel mouse. (On standard wheel mouse, the wheel value should be a multiple of 120).
  sendmouse wheel 1200

convertimage [source filename] [destionation filename]

Examples:
convertimage "c:\temp\test1.gif" "c:\temp\test1.png"
convertimage "c:\temp\test1.jpg" "c:\temp\test1.gif"

convertimages [source wildcard] [extension]

Examples:
convertimages "c:\temp\a*.gif" .png
convertimages "c:\temp\*.jpg" .gif

savescreenshot [filename] {x y width height}

Examples:
savescreenshot "c:\temp\shot.png"
savescreenshot "c:\temp\shot.png" 50 50 300 200
savescreenshot *clipboard* 150 150 400 400

savescreenshotfull [filename]

savescreenshotwin [filename]

Examples:
savescreenshotwin "c:\temp\win.png"
savescreenshotwin *clipboard*

shellcopy [source file or wildcard] [destination] {Flags}

• yestoall: Automatically answer 'Yes' to all questions.
• noerrorui: Don't display errors in user interface.
• silent: Silent mode - don't display progress information.
• nosecattr: Don't copy the security attributes of the file.

Examples:
shellcopy "c:\temp\*.*" "d:\temp"
shellcopy "c:\temp\*.*" "d:\temp" yestoall noerrorui

filldelete [source file or wildcard]

Examples:
filldelete "c:\temp\*.*"
filldelete "c:\temp\myfile.dat"

speak [type] [text/Filename] {rate} {volume} {.wav Output Filename} {Output Format}

• text: The second parameter contains a simple text.
• xml: The second parameter contains a text with Speech xml data.
• file: The second parameter contains a text filename.

The {rate} parameter is optional parameter that you can specify the Speech rate, a value between -10 (very slow) and 10 (very fast). The {volume} parameter is optional parameter that you can specify the volume of the Speech, a value between 0 and 100.

if {.wav Output Filename} contains a .wav filename, you should also specify one of the following output format strings in the {Output Format} parameter:
8kHz8BitMono, 8kHz8BitStereo, 8kHz16BitMono, 8kHz16BitStereo, 11kHz8BitMono, 11kHz8BitStereo, 11kHz16BitMono, 11kHz16BitStereo, 12kHz8BitMono, 12kHz8BitStereo, 12kHz16BitMono, 12kHz16BitStereo, 16kHz8BitMono, 16kHz8BitStereo, 16kHz16BitMono, 16kHz16BitStereo, 22kHz8BitMono, 22kHz8BitStereo, 22kHz16BitMono, 22kHz16BitStereo, 24kHz8BitMono, 24kHz8BitStereo, 24kHz16BitMono, 24kHz16BitStereo, 32kHz8BitMono, 32kHz8BitStereo, 32kHz16BitMono, 32kHz16BitStereo, 44kHz8BitMono, 44kHz8BitStereo, 44kHz16BitMono, 44kHz16BitStereo, 48kHz8BitMono, 48kHz8BitStereo, 48kHz16BitMono, 48kHz16BitStereo, TrueSpeech_8kHz1BitMono, CCITT_ALaw_8kHzMono, CCITT_ALaw_8kHzStereo, CCITT_ALaw_11kHzMono, CCITT_ALaw_11kHzStereo, CCITT_ALaw_22kHzMono, CCITT_ALaw_22kHzStereo, CCITT_ALaw_44kHzMono, CCITT_ALaw_44kHzStereo, CCITT_uLaw_8kHzMono, CCITT_uLaw_8kHzStereo, CCITT_uLaw_11kHzMono, CCITT_uLaw_11kHzStereo, CCITT_uLaw_22kHzMono, CCITT_uLaw_22kHzStereo, CCITT_uLaw_44kHzMono, CCITT_uLaw_44kHzStereo, ADPCM_8kHzMono, ADPCM_8kHzStereo, ADPCM_11kHzMono, ADPCM_11kHzStereo, ADPCM_22kHzMono, ADPCM_22kHzStereo, ADPCM_44kHzMono, ADPCM_44kHzStereo, GSM610_8kHzMono, GSM610_11kHzMono, GSM610_22kHzMono, GSM610_44kHzMono

Examples:
speak text ~$clipboard$
speak text "Please visit the Web site of NirSoft at http://www.nirsoft.net" 2 80
speak file "c:\temp\speak1.txt"
speak file "c:\temp\speak1.txt" 0 100 "c:\temp\speak.wav" 48kHz16BitStereo

elevate [Program] {Command-Line Parameters}

Examples:
elevate notepad.exe
elevate notepad.exe C:\Windows\System32\Drivers\etc\HOSTS
elevate "c:\program files\my software\abc.exe"

elevatecmd [NirCmd command]

Examples:
elevatecmd regsetval binary "HKLM\Software\Test" "Value1" "6a cb ab dd 80 86 95"

runas [Domain\User] [Password] [Process and Command-Line Parameters]

Examples:
runas admin1 Password1 "F:\Program Files\Mozilla Firefox\firefox.exe"
runas Domain01\user01 myp234Jk c:\temp\myprogram.exe
runas user01@domain.com Nm1923a "c:\temp\myprogram.exe" -a -k

runassystem [Process and Command-Line Parameters]

Example:
elevatecmd runassystem c:\windows\regedit.exe

runinteractive [Process and Command-Line Parameters]

Example:
runinteractive c:\windows\system32\taskmgr.exe

runinteractivecmd [NirCmd command]

Example:
runinteractivecmd savescreenshot "c:\temp\screenshot1.png"

trayballoon [Title] [Balloon Text] [Icon File] [Timeout]

Examples:
trayballoon "Hello" "This is a test..." "shell32.dll,22" 15000
trayballoon "Hello" "This is the text that will be appear inside the balloon !" "shell32.dll,-154" 10000
trayballoon "Hello" "This is the text that will be appear inside the balloon !" "c:\temp\icon1.ico" 10000

setconsolemode [mode]

setconsolecolor [forecolor] [backcolor]

• 0 - black
• 1 - blue
• 2 - green
• 3 - cyan
• 4 - red
• 5 - magenta
• 6 - brown
• 7 - white
• 8 - dark gray
• 9 - bright blue
• 10 - bright green
• 11 - bright cyan
• 12 - bright red
• 13 - bright magenta
• 14 - bright yellow
• 15 - bright white

Examples:
setconsolecolor 10 0
setconsolecolor 1 15

consolewrite [text]

debugwrite [text]

mediaplay [play time] [audio file]

Examples:
mediaplay 10000 "c:\temp\1.mp3"
mediaplay 180000 "c:\my files\1.wav"