Z-Score Toolbox

A system tray tool for measuring Z-scores directly on screen.

How it works

1. Click the tray icon and select Measure Z-Score, or press Ctrl+Alt+S anywhere.
2. A screenshot appears with a dark overlay — click four points in order:
   • Mean — the zero / mean line (blue)
   • +1 SD — one standard deviation above (green)
   • -1 SD — one standard deviation below (red)
   • Point — the value you want to measure (yellow)
3. A step-by-step panel on the left guides you through each click.
4. The Z-score is shown in a popup with a visual gauge, copy button, and option to measure again.

Press ESC at any time to cancel.

You can also trigger a measurement from anywhere on your desktop with the global hotkey Ctrl+Alt+S.

Draw Mode

For a faster workflow, use Draw Mode (Ctrl+Alt+D or tray menu → Draw Z-Score):

1. A screenshot appears with a dark overlay.
2. Draw a freehand line along the curve or data you want to measure.
3. The toolbox automatically calculates the Mean and SD from the drawn line and displays the Z-score — no need to click individual reference lines.

This is ideal when you can trace a visible trend and want a quick Z-score without manually identifying Mean/±1 SD lines.

Data Mode and History

Use Data Z-Score from CSV from the tray menu to calculate a Z-score from structured time-series data:

1. Select a CSV file.
2. Choose the numeric value column.
3. Enter a rolling lookback window, symbol, timeframe, measurement type, sign policy, and optional notes.
4. The toolbox calculates the latest rolling Z-score and stores the result in history.

Click, draw, and data measurements are saved to:

%USERPROFILE%\Documents\ZScoreToolboxHistory\

The history is grouped by date:

ZScoreToolboxHistory/
  2026/
    2026-05/
      2026-05-18/
        measurements.csv
        screenshots/
        inputs/

Each successful measurement appends a row to the daily measurements.csv. Visual modes save the captured screenshot automatically. Data mode can also copy the input CSV into the dated inputs/ folder and optionally save a desktop screenshot with the result.

---

Download

👉 ZScoreToolbox.exe No installation required — just run it on Windows 10/11.

Setup

1. Install Python 3.12 (Windows, via winget):

winget install Python.Python.3.12

2. Install dependencies:

pip install -r requirements.txt

3. Run:

py run.py

---

Build standalone EXE

1. Install PyInstaller:

pip install pyinstaller

2. Generate the application icon:

py build_tools/generate_icon.py

This creates assets\icon.ico with all required sizes (16–256 px). The build script runs this automatically, but you can also run it manually to preview the icon beforehand.

3. Build the EXE:

build_tools\build.bat

The build script generates the icon first, then runs PyInstaller with --icon=assets/icon.ico. The finished ZScoreToolbox.exe will be in the dist\ folder.

---

Project structure

ZScoreToolbox/
├── src/zscore_toolbox/
│   ├── main.py          # entry point, tray icon, measurement workflow
│   ├── capture.py       # screenshot capture via mss
│   ├── ui.py            # click overlay, step panel, result/error popups
│   ├── calculator.py    # visual Z-score calculation
│   ├── data_engine.py   # CSV-backed Z-score calculation
│   └── history.py       # dated CSV/screenshot history persistence
├── assets/              # icon.ico (for PyInstaller builds)
├── build_tools/
│   ├── build.bat        # PyInstaller build script
│   └── generate_icon.py # generates assets/icon.ico via Pillow
├── docs/                # implementation concepts
├── run.py               # development entry point
└── requirements.txt