Repository navigation
Releases: NSTechBytes/FinalShot
Releases · NSTechBytes/FinalShot
Release list
v1.7.2
Added
GIF recording
- Full animated GIF capture pipeline with disk-backed frame cache (stable memory use on long recordings)
- Capture modes: full screen, snap/region, predefined region, and window-by-title
- Toggle, stop, cancel, pause, and resume bangs (
-gif-start,-gif-stop,-gif-cancel,-gif-pause,-gif-toggle, and mode variants) - Live recording overlay (Stop / Pause / Abort + timer) that does not steal focus from Rainmeter
- Encoding progress window and optional state dialogs for invalid start/stop commands
- GIF lifecycle actions:
GifStartAction,GifStopAction,GifCancelAction,GifPauseAction,GifResumeAction,GifEncodingAction,GifFinishAction - Settings:
GifSavePath,GifFPS,GifDuration,GifQuality,GifCompression,GifSkipIdenticalFrames, overlay/encoding/dialog toggles, and GIF predefined region - Inter-frame encode optimisations (exact/near-duplicate coalesce, dirty banding) controlled by
GifCompression - Section variables for live status:
GetStatus(),IsRecording(),IsEncoding(),IsPaused(),GetFrameCount(),GetElapsedTime(),GetElapsedSeconds(),GetSavePath(),GetLastFileSize() - Example skin:
Resources/Skins/FinalShot/GIF/GIF.ini
OCR
- Region OCR via Windows.Media.Ocr (
-ocr) with clipboard copy - Settings:
OcrLanguage,OcrScaleFactor,OcrSingleLine,ShowOCRWindow,OCRFinishAction - Editable OCR result window when
ShowOCRWindow=1 GetLastOCRText()section variable- Example skin:
Resources/Skins/FinalShot/OCR/OCR.ini
Screenshots & windows
- Deferred window capture:
-whto store a window handle,-ws|/-ws|Titleto capture - Hotkeys:
HotkeyWindowHandle,HotkeyStoredWindow GetLastStoredWindow()section variable- Optional Windows 11 rounded-corner masking (
RoundWindowCorners) - Example skin:
Resources/Skins/FinalShot/WindowHandle/WindowHandle.ini
Notifications & paths
- Themed toast notification with optional sound (
NotificationSound) NotificationClickActionwith correct open of the toast’s capture (avoids staleGetLastScreenshotPath()resolve)GetLastScreenshotPath()/ last-saved path tracking- Bang helpers:
-open-last-screenshot,-open-last-gif
UI & hotkeys
UITheme(0Dark /1Light /2System) for notifications, encoding window, dialogs, snap overlays, and recording toolbar- Global hotkeys via low-level keyboard hook (
HotkeysEnabled,HotkeyFullscreen,HotkeyCustom,HotkeyOCR,HotkeyGifToggle, …)
Removed
- Removed the old
ExecuteBatchBangs.
Smart Window Snap
What's New
Smart Window Snap
Custom capture (-cs) now automatically detects and highlights windows and controls under your cursor — no more dragging by hand when you just want a window.
- Move the mouse over the overlay to highlight any window, panel, toolbar, sidebar, or child control
- A teal border appears around the detected region; everything outside is dimmed
- Click a highlighted region to capture it instantly
- Drag anywhere to fall back to a free-selection rectangle. Both modes work in the same overlay
- Moving more than 4 px after pressing the mouse button automatically switches to drag mode
- Right-click or Esc to cancel at any time
Window enumeration runs on a background thread so the overlay opens immediately with no freeze.
New Settings
| Setting | Description | Default |
|---|---|---|
DetectWindows |
Enable Smart Window Snap in custom capture. Set 0 for drag-only mode. |
1 |
DetectControls |
Also snap to child controls (toolbars, sidebars, panels). Has no effect when DetectWindows=0. |
1 |
Add to your skin measure to control the feature:
DetectWindows=1
DetectControls=1v1.7
Window Capture Modes
The Window Capture example has been split into two modes:
🟦 Exclusive Mode (UsePrintWindow=1)
Captures only the target window, excluding any overlapping or obscuring windows.
🟩 Screen-Based Mode (UsePrintWindow=0)
Captures exactly what’s visible on the screen, including any overlapping windows or content in front of the target window.
v1.6
🎉 What's New
Window Capture Feature
- Window Screenshot Mode (
-ws|windowtitle) - Capture specific windows by their exact title - Precise window boundary detection using Win32 APIs
- Perfect for capturing specific applications without background clutter
Beautiful Toast Notifications
- Adaptive Theme Support - Automatically matches Windows Dark/Light mode
- Screenshot Preview - Shows a thumbnail of your captured screenshot
- Branded Design - Clean, modern notification with "FinalShot" branding
- Auto-dismiss - Notifications fade out automatically after 4 seconds
- Interactive - Click anywhere or the close button (×) to dismiss instantly
- Notification Sound - Plays Windows notification sound on successful capture
Notification System ✨ NEW
- Theme-aware design (Dark/Light mode)
- Screenshot thumbnail preview
- Success confirmation with sound
- Non-intrusive bottom-right positioning
- Configurable via
ShowNotification=0/1
🎨 Notification Themes
The notification automatically adapts to your Windows theme:
Dark Mode:
- Dark background with light text
- Subtle shadows and borders
- Green "FinalShot" branding
Light Mode:
- Light background with dark text
- Clean, minimal design
- Crisp borders and contrast
v1.5
v1.4
Added
- Support for BMP, JPG, JPEG, and TIFF formats
- JPEG quality setting
- ShowCursor option
v1.3
Version 1.3
Added
- Predefined Region Mode (-ps):
Added support for capturing a screenshot from a predefined region specified by coordinates. - Debug Logging:
Introduced an optional debug logging feature that writes detailed information (such as DPI values, coordinate conversions, and capture regions) to a log file for troubleshooting. - Composite Capture for Multi-Monitor Setups:
Implemented logic to composite screenshots when the custom region spans monitors with different DPI scaling.
Changed
- DPI Awareness Improvements:
Updated the plugin to use per-monitor DPI awareness viaSetThreadDpiAwarenessContextto obtain accurate physical coordinates. - Custom Region Capture:
Refactored the custom region capture method so that the selection overlay displays a bold, dashed red border (without fill) and uses accurate physical coordinates for capture. - Full Screenshot Mode:
Modified full screenshot capture to useSystemInformation.VirtualScreento support multiple monitors.
Fixed
- Coordinate Conversion Issues:
Resolved issues where custom region selection did not accurately capture the intended area due to DPI scaling discrepancies. - Multi-Monitor DPI Issues:
Fixed problems with capturing custom regions on systems with monitors that have different DPI settings.
v1.2
What's New
- Capture fullscreenScreenshot using command
LeftMouseUpAction=[!CommandMeasure mFinalShot "-fs"] - Capture custom region Screenshot using command
LeftMouseUpAction=[!CommandMeasure mFinalShot "-cs"] - Fixed error when no region selected error.