Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Repository files navigation

ScreenShot Tool

A simple screenshot program, inspired by Greenshot, but each capture method can have individual settings for saving to file, clipboard or editor.

image

Hotkeys

Hotkeys can be changed in Options

FuncionDefault Hotkey
RegionPrintscreen
WindowAlt + PrintScreen
ScreenCtrl + PrintScreen
All screensNo preset
Open last folderNo preset

Capture Modes

  • Region
  • Window
  • Screen
  • All screens

Region capture

During region capture, the region selection interface will appear on the monitor that the mouse cursor is on.
Click and drag the mouse to create a selection. This can be refined with the keys shown below.

To confirm the region, press Enter to save to file, C to copy the selection to the clipboard or E to open the selection in the Editor. Press Escape to exit.

If you select the option "Complete capture when releasing mouse", the output is instead decided by the otions for saving to file or clipboard (Options > Modes: Region)

When adjusting the size of the region, arrows will indicate what edges are affected by arrow key presses. When adjusting the position of the region, arrows are shown in all directions.

image

Enter Save image to file and exit Region capture
C Copy image to clipboard and exit Region capture
E Open the selection in the Editor and exit Region capture
Esc Exit region capture, discard selection
S Size adjustment mode (Default)
P Position adjustment mode
Arrow Key Size / Position adjustement
Ctrl+Arrow Key Size adjustment side selection
Shift Hold Shift to adjust region by 10 pixels instead of 1

Region framerate

The specified framerate in Options sets the max amount of times per second the region UI will update.
If this is too high, the system can't catch up, and lag may be worse than if you set a lower framerate. A good system should be able to handle 60fps. Default is 30fps. (Options > Mode: Region)


Window capture

Captures the active window. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Screen capture

Captures the screen the mouse cursor is currently in. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


All Screens capture

Captures all screens in a single image. Save to file, open in Editor or copy to clipboard based on options (Options > Modes: Window)


Capture output

File name variables

When saving to file, the name of the active application, time or incrementing numbers can be included in the file or folder name.
The default file name is $w $d $t $c, which will output something like "MyWindow 2023-12-31 16:02 003"

$w Active Window title ("Region" or "Screen" is used in those modes)
$d Date in ISO format (2023-12-31)
$t Time
$ms Milliseconds
$c Counter number (auto increments)
$TAG Add tag names, multiple active tags is separated with comma. See "Tags" below

You can also use longer form variables, these are identical to Greenshot's variable format.

${DATE} Date in ISO format (2023-12-31)
${YYYY} Year
${MM} Month number
${DD} Day number
${hh} Hour
${mm} Minute
${ss} Second
${ms} Millisecond
${NUM} Counter number (auto increments)
${title} Active Window title ("Region" or "Screen" is used in those modes)
${user} User account name
${domain} User's domain
${hostname} PC name

Title tweaks

The title of the active window when using $w can be adjusted to make file names nicer.

Window title max length

Limits the name length to prevent long file names.

Split Window title using string

If a window title is dynamically altered by the file it's viewing, extract just the part you're interested in.

Which of the split name element to use is set by the option "Keep split text in index", where 0 is the first element.

Example: "ImageEditor - mypicture.png - v12.2"
Split with " - "
Keep split text in index: 0
Result: $w outputs "ImageEditor"
Keep split text in index: 1
Result: $w outputs "mypicture.png"

Crop Window capture

If on, this option crops the captured window from top, left, right and bottom.
This can be used to remove the window title bar and edges. In the Windows 11 default theme, values of 32,10,10,10 will remove these.

Counter number

When using the $c or ${NUM} variable, it inserts the number in this field. The number is saved between sessions.

Tags and the $TAG variable

Tags are used for adding info to the file or folder name that can be changed on the fly.

To create and enable tags, use the Edit Tags window (Main window > Edit > Edit Tags).

Tags have four parts:

  • The checkbox enables the tag
  • The Name is what is output in the $TAG
  • The Description is for adding an explanatary note to yourself, and is not used in $TAG output
  • The Category is used for filtering the list. You can set the filter using the Filter text box. Any new tags created will have the category pre-filled with the current filter text.

The Description and Category fields are optional.

When $TAG is present in the file or folder name setting, any enabled tags will be added in the name. If there are multiple active tag, they are separated with comma.

Note that $TAG variable is all upper case, to distinguish it from the $t Time variable

Example:
You have the current tags in the Tag View:
☑ Food
☐ Cars
☑ Recipe
Your folder and file names in settings is:
D:\Captures\$w\$TAG
$d $t $TAG
The resulting output file name:
D:\Captures\WebBrowser\Food, Recipe\2024-05-13 13:44 Food, Recipe.png
If no tags are enabled, a subfolder will not be created even though the \$TAG is present

The available tags are saved in %localappdata%\ScreenShotTool\TagData\tags.txt


Screenshot Editor

editor screenshot

You can open an image in the editor by using the Edit menu in the main application window, or when performing a region capture by pressing E.

Select the type of graphic symbol to add from the vertical list on the left. The new symbol will be added with the colors and settings at the top of the window.

You can move, edit and scale symbols after you have placed them by clicking and dragging the symbol, or using the Properties panel on the right.

KeysFunction
Ctrl+CCopy the current image or selected region
Ctrl+VPaste an image or text into the editor
Arrow keysMove the selected symbol(s) around
Shift + Arrow keysMove the selected symbol(s) faster
Shift + dragScale proportional or create square symbol
Ctrl + clickMulti select or deselect symbol
HomeMove the selected symbol to the front
EndMove the selected symbol to the back
EnterComplete an active crop selection
Esc / right clickCancel drawing a symbol
DeleteDelete selected symbol(s)
Ctrl+OOpen a file
Ctrl+SSave the current image (Save As)
Ctrl+PPrint the current image

Tools

Highlighter blend Modes

KeysFunction
NormalImage is replaced by the selected color: =C2
MultiplyDarkened by the selected color: =C1*C2
DivideLightened by the selected color: =C1\C2
LightenOnly colors that are darker than color2 are lightened =Max(C1,C2)
DarkenOnly colors that are lighter than color2 are darkened =Min(C1,C2)
DesaturateConvert to grayscale, use ""Affect color channel"" to adjust amount
InvertInverts the color
InvertBrightnessInverts the brightness, but keeps the hue. Adjust using selected color, More RED for Perceptual Brightness, More GREEN to allowing desaturate towards white
ContrastWhite = full contrast, Gray = normal, Black = no contrast, Selected color hue will have an effect as well

Images in the clipboard

If you copy an image into the clipboard (typically from another application) you can use menu options or the system tray icon for quick export options

Save clipboard image to file

If there's an image in the clipboard, opens a save dialog to save that image to a new file.

Copy clipboard image to file drop

When selecting this, the image in the clipboard is converted into a file that you can paste into a folder.

In the background, the clipboard image is saved to a new file in a temporary folder (program path\filedrop), then the adds it to the file drop list in the clipboard.

When exiting the program, any droppable files are deleted from this temporary folder.

The first time you do this, a notification will inform you that a folder has been created to store the temp files.

Fix clipboard image

If you copy an image from an application and can't paste it into an older application, use this function to convert the clipboard image into a more compatible format, then paste it normally.

An example of this problem: Copying an image from MS Teams chat and into an outdated program like Lotus Notes.

Application options

Start Hidden

Start the application without appearing on screen or on the task bar. Interact with it via the System Tray icon or hotkeys. You can add the application to start automatically by placing a shortcut in the Startup folder: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup

System tray tooltips

System tray tooltip options will display a notification in the lowe right of the screen when capturing, creating folders, or there's a problem.

Thumbnails

Specify the size of the thumbnails used in the application. This does not affect the saved files. "Crop thumbnails" will make the thumbnails retain their aspect ration, but parts of the image are cut in the capture list thumbnail.


Key codes for hotkey options:

https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=windowsdesktop-7.0

KeyKeycode
0-90 to 9
A-ZA to Z
F1-F24F1 to F24
The BACKSPACE keyBack
The TAB keyTab
The RETURN keyReturn
The ENTER keyEnter
The PAUSE keyPause
The CAPS LOCK keyCapsLock
The ESC keyEscape
The SPACEBAR keySpace
The PAGE UP keyPageUp
The PAGE DOWN keyPageDown
The END keyEnd
The HOME keyHome
The LEFT ARROW keyLeft
The UP ARROW keyUp
The RIGHT ARROW keyRight
The DOWN ARROW keyDown
The PRINT SCREEN keyPrintScreen
The INS keyInsert
The DEL keyDelete
The left Windows logo keyLWin
The right Windows logo keyRWin
The 0 key on the numeric keypadNumPad0
The 1 key on the numeric keypadNumPad1
The 2 key on the numeric keypadNumPad2
The 3 key on the numeric keypadNumPad3
The 4 key on the numeric keypadNumPad4
The 5 key on the numeric keypadNumPad5
The 6 key on the numeric keypadNumPad6
The 7 key on the numeric keypadNumPad7
The 8 key on the numeric keypadNumPad8
The 9 key on the numeric keypadNumPad9
The Multiply keyMultiply
The Add keyAdd
The Separator keySeparator
The Subtract keySubtract
The Decimal keyDecimal
The Divide keyDivide
The NUM LOCK keyNumLock
The SCROLL LOCK keyScroll
The OEM angle bracket or backslash key on the RT 102 key keyboardOemBackslash
The OEM close bracket key on a US standard keyboardOemCloseBrackets
The OEM comma key on any country/region keyboardOemcomma
The OEM minus key on any country/region keyboardOemMinus
The OEM open bracket key on a US standard keyboardOemOpenBrackets
The OEM period key on any country/egion keyboardOemPeriod
The OEM pipe key on a US standard keyboardOemPipe
The OEM plus key on any country/region keyboardOemplus
The OEM question mark key on a US standard keyboardOemQuestion
The OEM singled/double quote key on a US standard keyboardOemQuotes
The OEM Semicolon key on a US standard keyboardOemSemicolon
The OEM tilde key on a US standard keyboardOemtilde

About

Capture and edit screenshots with customizable outputs

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages