Skip to content

BenjaminKobjolke/FastKeyboardScreenshot

Repository files navigation

Keyboard Screenshot

Create a screenshot by selecting a region with the keyboard and copy it to the clipboard

Demo

How to use

  • Press Alt Shift Q to start
  • Move the mouse cursor with the arrow keys or hjkl to the start position
  • Press space
  • Move the mouse cursor to the end position
  • Press space

Your screenshot will be copied to the clipboard

Hold down shift while moving the cursor to decrease the speed.

Requirements & Install

  • You have AHK/AHK_L --> use KeyboardScreenshot.ahk
  • You don't have AHK/AHK_L --> use KeyboardScreenshot.exe from Releases
  • run install.bat

Updates

Screenshot the same region again

after you created at least one screenshot you can do the following

  • Press Alt Shift Q to start
  • activate any of the additional features, like resizing or saving to file
  • press r

Your screenshot will be copied to the clipboard (using the same region as your last screenshot)

Screenshot with delay (useful for dropdown menus)

  • Press Alt Shift Q to start
  • Press D to enable delay
  • Move to the start position and press space
  • Move to the end position and press space
  • The screenshot will be automatically taken after 5 seconds

This can also be combined with the "same region" feature:

  • Press Alt Shift Q to start
  • Press D to enable delay
  • Press r to take a screenshot of the same region as last time
  • The screenshot will be automatically taken after 5 seconds

Screenshot scale

Press 1,2,3 during screenshot process to scale the final output by 0.75, 0.5 or 0.25

Capture mouse cursor

Press m during the screenshot process to toggle mouse cursor capture on/off. When enabled, the mouse cursor will be included in the screenshot. The screenshot will also be copied to the clipboard as usual.

Show screenshot in window

Press w during the screenshot process to toggle window preview on/off. When enabled, the screenshot will be displayed in a dark-themed preview window after capture. Press ESC or click the X button to close the preview window. The screenshot will also be copied to the clipboard as usual. The window position and size are saved automatically.

Preview Window Features:

The preview window supports multiple editing modes. Press F1 in the preview window to see all shortcuts.

  • f - Save screenshot to file
  • p - Copy screenshot to clipboard
  • u - Upload screenshot
  • Shift+U - Open last uploaded URL in browser
  • c - Enter crop mode
  • a - Enter arrow mode
  • n - Enter number mode
  • r - Enter rectangle mode
  • Esc - Close window (or cancel current mode)

Crop Mode:

  • Use hjkl or arrow keys to shrink from edges
  • Hold Shift to extend edges outward
  • Press Enter to apply crop
  • Press Esc to cancel

Arrow Mode: Draw arrows on your screenshot to highlight areas.

  • Use hjkl or arrow keys to move cursor (Shift for faster)
  • Press Space to set start point, then Space again to set end point
  • Press c to cycle arrow color (red/blue/green/yellow/black)
  • Press i/u to increase/decrease arrow size
  • Press Enter to apply arrows to image
  • Press Esc to cancel

Arrow color and size are saved to settings.ini.

Number Mode: Add numbered circle annotations (callouts) to your screenshot.

  • Use hjkl or arrow keys to move cursor (Shift for faster)
  • Press 1-9 to place numbers 1-9, press 0 to place number 10
  • Press c to cycle color (red/blue/green/yellow/black)
  • Press i/u to increase/decrease circle size
  • Press Enter to apply numbers to image
  • Press Esc to cancel

Number color and size are saved to settings.ini.

Rectangle Mode: Draw rectangle outlines on your screenshot to highlight areas.

  • Use hjkl or arrow keys to move cursor (Shift for faster)
  • Press Space to set first corner, then Space again to set opposite corner
  • Press c to cycle color (red/blue/green/yellow/black)
  • Press i/u to increase/decrease line thickness
  • Press z to undo the last rectangle
  • Press Enter to apply rectangles to image
  • Press Esc to cancel

Rectangle color and size are saved to settings.ini.

Capture active window

Press a during the screenshot process to capture the active window immediately. This skips the manual region selection and captures the entire active window. All modifiers (resize, save to file, cursor capture, etc.) are respected. The screenshot will also be copied to the clipboard as usual.

Show keyboard shortcuts

Press F1 during the screenshot process to display a help window with all available keyboard shortcuts. Press F1 again or Esc to close the help window.

Save screenshot to file

Press f during the screenshot process to save the screenshot to a file. By default, screenshots are saved in the subfolder "screenshots" relative to the script directory. You can change this location in the settings.ini file by modifying the ScreenshotFolder value. See settings_example.ini for an example configuration. The screenshot will also be copied to the clipboard as usual.

Upload screenshot

Press u during the screenshot process to upload the screenshot. The screenshot URL will be copied to the clipboard after upload.

Built-in FTP upload: Set UseInBuildFTP=1 in settings.ini and configure your FTP server details. A tooltip will show upload progress and the final URL. Press 'o' in the tooltip to open the URL in your browser, or press Escape to dismiss. See settings_example.ini for configuration options.

Tooltip duration (in settings.ini):

[General]
ActionTooltipDuration=5000

ShareX upload: Set UseInBuildFTP=0 (default) to use ShareX for uploading. Note that you need to have ShareX installed and configured for this to work.

edit with sharex

Press e during the screenshot process to edit the screenshot with sharex. It will also be copied to the clipboard as usual. Note that you need to have sharex installed and configured for this to work. Currently te path is fixed to C:\Program Files\ShareX\ShareX.exe

OCR (Optical Character Recognition)

Press o during the screenshot process to run OCR on the screenshot. The text will be copied to the clipboard (not the image).

OCR modes:

  • OCR only: Text is copied to clipboard. Press 'o' in the tooltip to open in your default text editor.
  • OCR + Save (o + f): Text is saved as a .txt file and copied to clipboard.
  • OCR + Upload (o + u): Text is saved as .txt, uploaded to FTP, and URL is copied to clipboard.
  • OCR + Window (o + w): Text is displayed in a dark-themed preview window.

Text Preview Window settings (in settings.ini):

[TextPreviewWindow]
FontSize=14

Licence

GPL 2.0

Original code

I found the code that this tool is based on here:

Autohotkey Forum

About

A windows utility to create a region screenshot by using the keyboard only

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •