Windows: install script, Start Menu shortcut with hotkey

- install-windows.ps1: copies binary, adds to user PATH, creates a
  Start Menu .lnk shortcut with Ctrl+Shift+R hotkey via WScript.Shell
- docs/manual-shortcut-setup.md: Windows section with .lnk, PowerToys,
  and AutoHotkey alternatives
- README: Windows subsection under Global keyboard shortcut

Author: pgivel

README.md

@@ -81,6 +81,17 @@ After building the binary, run the install script:
 
 The script copies the binary and creates an Automator Quick Action ("Launch Screen Ruler"). Then bind a shortcut (e.g. **⌘⇧R**) in **System Settings → Keyboard → Keyboard Shortcuts → Services**.
 
+### Windows
+
+After building the executable, run the install script in PowerShell:
+
+```powershell
+.\install-windows.ps1                                          # installs to the current directory
+.\install-windows.ps1 -InstallDir "$env:LOCALAPPDATA\screen-ruler"  # or specify a directory
+```
+
+The script copies the binary, adds it to the user `PATH`, and creates a Start Menu shortcut with a **Ctrl+Shift+R** hotkey.
+
 ---
 
 For manual setup on any platform, see [docs/manual-shortcut-setup.md](docs/manual-shortcut-setup.md).

docs/manual-shortcut-setup.md

@@ -88,3 +88,29 @@ Any launcher or shortcut manager that can run an arbitrary command will work. Po
 ### Option 3: Third-party tools
 
 Apps like [Raycast](https://www.raycast.com/), [Alfred](https://www.alfredapp.com/), or [Hammerspoon](https://www.hammerspoon.org/) can bind a global hotkey to run an arbitrary command. Point it at the `screen-ruler` binary.
+
+## Windows
+
+### Option 1: Start Menu shortcut hotkey
+
+1. Place `screen-ruler.exe` in a permanent directory.
+2. Create a shortcut (`.lnk`) to it in the **Start Menu** folder:
+   - Press `Win+R`, type `shell:programs`, and press Enter.
+   - Right-click → **New → Shortcut**, point it at `screen-ruler.exe`.
+3. Right-click the shortcut → **Properties** → **Shortcut key**, press your preferred combo (e.g. **Ctrl+Shift+R**) → **OK**.
+
+> The hotkey only works while the `.lnk` remains in the Start Menu or Desktop folder.
+
+### Option 2: PowerToys
+
+[PowerToys Keyboard Manager](https://learn.microsoft.com/en-us/windows/powertoys/keyboard-manager) can remap a key combination to launch an application. Add a shortcut that runs `screen-ruler.exe`.
+
+### Option 3: AutoHotkey
+
+Create an `.ahk` script:
+
+```ahk
+^+r::Run "C:\path\to\screen-ruler.exe"
+```
+
+This binds **Ctrl+Shift+R** to launch screen-ruler.

install-windows.ps1

@@ -0,0 +1,106 @@
+<#
+.SYNOPSIS
+    Install screen-ruler and register a global keyboard shortcut on Windows.
+
+.DESCRIPTION
+    Copies the built screen-ruler.exe binary to an install directory (default:
+    current directory), creates a Start Menu shortcut with a Ctrl+Shift+R
+    hotkey, and adds the binary to the user PATH.
+
+.PARAMETER InstallDir
+    Directory to install the binary into (default: current directory).
+
+.EXAMPLE
+    .\install-windows.ps1
+    .\install-windows.ps1 -InstallDir "$env:LOCALAPPDATA\screen-ruler"
+#>
+
+param(
+    [string]$InstallDir = (Get-Location).Path
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$AppName = 'Screen Ruler'
+$AppId   = 'screen-ruler'
+$Binary  = Join-Path $PSScriptRoot 'dist' 'screen-ruler.exe'
+
+# --- Locate the built binary ------------------------------------------------
+
+if (-not (Test-Path $Binary)) {
+    Write-Error "Binary not found at $Binary.`nBuild it first:  pyinstaller screen_ruler.spec" -ErrorAction Continue
+    exit 1
+}
+
+# --- Copy binary to install dir ---------------------------------------------
+
+if (-not (Test-Path $InstallDir)) {
+    New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
+}
+$InstallDir = (Resolve-Path $InstallDir).Path
+$ExecPath   = Join-Path $InstallDir "$AppId.exe"
+
+$BinaryFull = (Resolve-Path $Binary).Path
+if ($ExecPath -ne $BinaryFull) {
+    Copy-Item -Path $BinaryFull -Destination $ExecPath -Force
+    Write-Host "Installed binary -> $ExecPath"
+} else {
+    Write-Host "Binary already at $ExecPath"
+}
+
+# --- Add to user PATH (if not already present) ------------------------------
+
+$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+
+# Normalize install directory for comparison
+$normalizedInstallDir = [IO.Path]::GetFullPath($InstallDir).TrimEnd('\').ToLowerInvariant()
+
+# Split existing PATH into entries, normalize, and check for presence
+$pathEntries = @()
+if (-not [string]::IsNullOrEmpty($userPath)) {
+    $pathEntries = $userPath -split ';' | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
+}
+
+$hasInstallDir = $false
+foreach ($entry in $pathEntries) {
+    $normalizedEntry = [IO.Path]::GetFullPath($entry).TrimEnd('\').ToLowerInvariant()
+    if ($normalizedEntry -eq $normalizedInstallDir) {
+        $hasInstallDir = $true
+        break
+    }
+}
+
+if (-not $hasInstallDir) {
+    if ([string]::IsNullOrEmpty($userPath)) {
+        $newPath = $InstallDir
+    } else {
+        $newPath = "$userPath;$InstallDir"
+    }
+    [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+    Write-Host "Added $InstallDir to user PATH (restart your terminal to pick it up)."
+}
+
+# --- Create Start Menu shortcut with hotkey ---------------------------------
+
+$startMenu   = [Environment]::GetFolderPath('StartMenu')
+$programsDir = Join-Path $startMenu 'Programs'
+$lnkPath     = Join-Path $programsDir "$AppName.lnk"
+
+$shell    = New-Object -ComObject WScript.Shell
+$shortcut = $shell.CreateShortcut($lnkPath)
+$shortcut.TargetPath  = $ExecPath
+$shortcut.Description = 'Measure on-screen UI elements using edge detection'
+$shortcut.WorkingDirectory = $InstallDir
+# Hotkey format: "Modifier+Key" — Ctrl+Shift+R
+$shortcut.Hotkey = 'Ctrl+Shift+R'
+$shortcut.Save()
+
+Write-Host "Created Start Menu shortcut -> $lnkPath"
+Write-Host "  Hotkey: Ctrl+Shift+R"
+
+# --- Done -------------------------------------------------------------------
+
+Write-Host ''
+Write-Host "Done. Press Ctrl+Shift+R to launch $AppName."
+Write-Host 'Note: the shortcut hotkey requires the .lnk to stay in the Start Menu folder.'