FinalShot

A powerful Rainmeter plugin for capturing screenshots directly from your skins.
FinalShot supports full‑screen captures, predefined regions, custom selection, multi‑monitor composition, cursor inclusion, JPEG quality control, and post‑capture actions.

---

Features

• Full‑Screen Capture (-fs)
  Capture the entire virtual screen (all monitors).

• Predefined Region (-ps)
  Capture a fixed rectangle specified by X, Y, Width, and Height.

• Custom Selection (-cs)
  Draw a region on‑the‑fly with your mouse.

• Multi‑Monitor Composition
  Seamlessly stitch captures across multiple monitors.

• Cursor Inclusion
  Optionally include the mouse cursor in your screenshots.

• JPEG Quality Control
  Adjust JPEG compression quality (0–100).

• Finish Actions
  Execute any Rainmeter bang or external command after saving.

• Debug Logging
  Optional logging with automatic log rotation.

---

Requirements

• Windows 7 or later
• Rainmeter 4.x or later
• .NET Framework 4.5 or higher

---

Installation

1. Build the plugin from source (or download the precompiled FinalShot.dll).
2. Copy FinalShot.dll into your Rainmeter Plugins folder (e.g. …\Rainmeter\Plugins\).
3. Edit your Rainmeter skin .ini to reference the plugin.

---

Usage

1. Define a Measure

[MeasureScreenshot]
Measure=Plugin
Plugin=FinalShot
; Where to save the screenshot:
SavePath=C:\Users\You\Pictures\shot.png
; 1 = include cursor, 0 = no cursor
ShowCursor=1
; JPEG quality (only if SavePath ends in .jpg/.jpeg)
JpgQuality=85
; Predefined region (for -ps):
PredefX=100
PredefY=100
PredefWidth=800
PredefHeight=600
; After saving, execute this bang or app:
ScreenshotFinishAction=[!Log "Screenshot taken!"]
; Enable debug logging (1 = on, 0 = off)
DebugLog=0
; (Optional) custom log path:
; DebugLogPath=C:\Temp\FinalShotDebug.log

2. Capture with Bangs

• Full‑Screen

  [!CommandMeasure MeasureScreenshot "-fs"]

• Predefined Region

  [!CommandMeasure MeasureScreenshot "-ps"]

• Custom Selection

  [!CommandMeasure MeasureScreenshot "-cs"]

• Batch Execution
  You can also call:

  [!CommandMeasure MeasureScreenshot "ExecuteBatch 1"]  ; full-screen
  [!CommandMeasure MeasureScreenshot "ExecuteBatch 2"]  ; custom
  [!CommandMeasure MeasureScreenshot "ExecuteBatch 3"]  ; predefined

---

Settings Reference

Setting	Description	Default
SavePath	Full path (including filename & extension) where the screenshot will be saved.	(empty)
ScreenshotFinishAction	Rainmeter bang or command to run after saving.	(empty)
ShowCursor	Include mouse cursor in capture? (1 = yes, 0 = no)	0
JpgQuality	JPEG compression quality (0–100). Only applies to .jpg or .jpeg files.	70
PredefX, PredefY	Top‑left coordinates of the predefined capture region.	0
PredefWidth, PredefHeight	Width & height of the predefined capture region.	0
DebugLog	Enable debug logging? (1 = yes, 0 = no).	0
DebugLogPath	Custom path for the debug log file (overrides default FinalShotDebug.log).	(empty)

---

Examples

[MeasureFull]
Measure=Plugin
Plugin=FinalShot
SavePath=#@#Screenshots\Full.png
ShowCursor=1
ScreenshotFinishAction=[!Refresh]

[MeasureRegion]
Measure=Plugin
Plugin=FinalShot
SavePath=#@#Screenshots\Region.png
PredefX=200
PredefY=150
PredefWidth=1024
PredefHeight=768
ShowCursor=0

---

Debug Logging

To troubleshoot, enable DebugLog=1. Logs are written to FinalShotDebug.log (or your custom DebugLogPath) and automatically rotate at 5 MB.

---

Building from Source

1. Open the solution in Visual Studio.
2. Ensure your target framework is set to .NET Framework 4.5 or higher.
3. Build in Release mode.
4. Copy the resulting FinalShot.dll to your Rainmeter plugins folder.

---

License

This project is licensed under the MIT License. See LICENSE for details.