Launch from Command Prompt
Use hprsnap.exe [parameters] to start HyperSnap with the switches you need.
Command line usage for scripted and repeatable capture workflows.
HyperSnap can be launched from Command Prompt, batch files, and scripts to automate capture, open, save, print, and conversion tasks.
Quick start
Wait for the operation to finish
Use start /wait hprsnap.exe [parameters] in scripts when a later step must wait until HyperSnap completes its work.
Put HyperSnap on PATH
If the HyperSnap program folder is in your PATH, you can call hprsnap.exe from any working directory.
The examples below use sample paths only. Replace them with folders and file names that exist on your own system.
Command line switches
These options are intended for power users, automation workflows, and repeatable capture jobs. They can be used from scripts, batch files, or any other Windows automation tool that can launch a program with arguments.
| -quicksave |
Turns on QuickSave, even if it was turned off in previous sessions or by default. Additional -QuickSave options can start timed auto-save. Example combinations:
These examples start the program hidden, iconic, or open, repeat the snap every 5000 ms, increment the file name counter from 1, and stop when the counter reaches 5. To disable numbering in the file name, set the second number in -QuickSave to 0. For example, To disable the maximum count, set the last number to 0. Capture then repeats until you press the stop-capture hotkey, which is F11 by default. |
| -hidden |
Runs the program with its window hidden, so you operate it only with hotkeys. You should enable Quick Print, Copy each capture to clipboard, or automatic saving in Capture Settings first. Otherwise you will not be able to choose a file or direct output to a useful location. |
| -dumpopts |
Reads the program's registry entries and writes them to an INI file in HyperSnap's home directory. This is useful for debugging or support. You can send that INI file to support when requested. |
| -readopts |
Reads the program's registry entries back from the INI file created with -dumpopts and writes them to the Windows registry. This is a convenient way to restore defaults or repair a damaged configuration. |
| -initfrom:filename |
Starts HyperSnap by loading settings from a specific INI file. Example: This is useful when different users or workflows need different hotkeys or capture settings. When started this way, changes do not go back to the default registry location. They are written back to the INI file you loaded. |
| -snap |
Captures a screen or a portion of the screen once, optionally prints or saves it, and can then exit without showing the HyperSnap window. This option accepts sub-options separated by colons. Example: :x is the X coordinate where capture starts. If omitted, HyperSnap assumes 0. :y is the Y coordinate where capture starts. If omitted, HyperSnap assumes 0. :w is the capture width in pixels. If omitted, capture extends to the right edge of the screen. :h is the capture height in pixels. If omitted, capture extends to the bottom of the screen. :window lets you select a window with the mouse. :region lets you select a rectangular capture region. :awin captures the currently active window, including its frame and title. :acli captures the active window client area without the title bar or frame. |
| -open:[filename] -open [filename] |
Runs HyperSnap and opens the specified image file if it exists and is in a supported graphics format. HyperSnap then performs any later command line actions such as -print or -save, which makes this useful for format conversion or batch printing. Examples:
|
| -colsubst |
Performs color substitution on an opened image according to the substitution table previously defined in an interactive HyperSnap session under Color > Substitute Colors. Example: |
| -scale:[percent] |
Scales the image captured with -snap or opened from a file by the percentage you specify. Example: This opens
This opens You can use this in a batch loop. Example:
This resizes all JPEG files in the current folder to 4% of their original size and saves them with the prefix To preserve the originals, save into another folder, for example |
|
Designed for use after -snap to print the captured image. It accepts sub-options separated with colons. :l prints in landscape mode. Default is portrait. :inv inverts black and white. :bw prints black and white only. :fr draws a frame around the printed image. :sNN scales the output, where NN is the percentage. Default is 100%. :af auto-fits the picture to fill the page while preserving aspect ratio. :pd displays the Print dialog so you can choose a printer and options. If :pd is omitted, HyperSnap prints to the default printer. Example: |
|
| -save |
Designed for use after -snap to save the captured image to a supported file format. The very next argument must be the destination file name, including its extension. Examples of format switches: :gif saves as GIF :gif:i saves as interlaced GIF :jpg saves as JPEG with the default quality of 75% :jpg:qNN saves as JPEG with quality NN% :jpg:p saves as progressive JPEG and can be combined with :qNN :bmp saves as BMP and may be omitted because it is the default :bmp:c1, :bmp:c4, :bmp:c8, :bmp:c24 select bitmap color depth Accepted file types include Additional modifiers include :a to append when the format supports it, :c1 through :c32 for color depth, :i or :p for interlaced or progressive formats, and :qNN for quality settings on JPEG and CMP. Examples:
|
| -newwin |
Allows a second instance of HyperSnap to start. Without this switch, launching HyperSnap while it is already running normally activates the existing window instead of opening another one. |
| -defprn:prn_name |
Makes HyperSnap use a printer other than the system default as its default printer. The printer name must match exactly what appears in the Windows Printers folder. If the name contains spaces, enclose the entire command in double quotes. Examples:
|
| -ra |
Restores advanced options to the same state they had when HyperSnap was last closed. These advanced options include Capture Settings, Crop and Scale enable mode, View and Edit selection, and all "auto-apply" options on the Image and Color menus. This is mostly useful for advanced users who want those settings preserved from one scripted or production session to the next. |
| -exit |
Causes HyperSnap to exit after it finishes the requested operation. For example, if you use -snap without -save or -print, HyperSnap would normally remain running. Adding -exit forces it to quit when the task is done. |