MACRO: ScreenCapture: Select Region & Save to File with Date/Time Stamp [Example]
~~~ VER: 1.0 2020-01-03 ~~~
Requires: KM 8.2.4+ macOS 10.11 (El Capitan)+
(Macro was written & tested using KM 9.0+ on macOS 10.14.5 (Mojave))
DOWNLOAD Macro File:
ScreenCapture- Select Region & Save to File with Date-Time Stamp [Example].kmmacros
Note: This Macro was uploaded in a DISABLED state. You must enable before it can be triggered.
Example Output
ReleaseNotes
Author.@JMichaelTX
PURPOSE:
-
ScreenCapture: Select Region & Save to File with Date/Time Stamp
- Prompt User for Output Details
- User Draws Rectangle to Capture Region
HOW TO USE
- First, make sure you have followed instructions in the Macro Setup below.
- Open the App and Document where you want to do a screen shot
- Trigger this macro.
- Enter Output Data: File Name, File Format, Output Folder
- NOTE: The Output Folder MUST already exist
- Draw a rectangle to select capture area
- Output file is revealed in Finder
- For Details on the Bash
screencapture
command, see:
TIP: How to Automate Screen Capture Using Bash screencapture Command
MACRO SETUP
-
Carefully review the Release Notes and the Macro Actions
- Make sure you understand what the Macro will do.
- You are responsible for running the Macro, not me. ??
.
Make These Changes to this Macro
- Assign a Trigger to this macro.
- Move this macro to a Macro Group that is only Active when you need this Macro.
- ENABLE this Macro, and the Macro Group it is in.
.
-
REVIEW/CHANGE THE FOLLOWING MACRO ACTIONS:
(all shown in the magenta color)- DateTimeForFile format
- Default values for Prompt for Output Data
REQUIRES:
- KM 8.2+
- macOS 10.11.6 (El Capitan)+
TAGS: @ScreenShot @ShellScript
USER SETTINGS:
- Any Action in magenta color is designed to be changed by end-user
ACTION COLOR CODES
- To facilitate the reading, customizing, and maintenance of this macro,
key Actions are colored as follows: - GREEN -- Key Comments designed to highlight main sections of macro
- MAGENTA -- Actions designed to be customized by user
- YELLOW -- Primary Actions (usually the main purpose of the macro)
- ORANGE -- Actions that permanently destroy Variables or Clipboards,
OR IF/THEN and PAUSE Actions
USE AT YOUR OWN RISK
- While I have given this a modest amount of testing, and to the best of my knowledge will do no harm, I cannot guarantee it.
- If you have any doubts or questions:
- Ask first
- Turn on the KM Debugger from the KM Status Menu, and step through the macro, making sure you understand what it is doing with each Action.