User Guide

How to measure a mechanical watch with Timegrapher: every button, pane and function, what it does, and why you’d use it.

Timegrapher states measured facts. It doesn’t grade a watch or say what is wrong with it. Interpreting the facts is the watchmaker’s job; this guide explains what each fact means and where it can mislead.

Contents

Start

  1. What a Timegrapher Measures: the beat, its three sounds, rate, amplitude and beat error
  2. Your First Take: Quick Listen, from install to a saved take
  3. Setting Up the Microphone: the input, the level, clipping, automatic gain and Quartz Correction

The App

  1. The Window: the top row, Bench and Watches, panes, the status bar, menus and keys
  2. The Readings Cards and the Calibre Card: the position, the calibre, Listen, the readings, their ± and chips
  3. The Paper Strip: reading the strip, moving around, the track, masking and the Position Brush
  4. The Tick Tock Profile and the Scope: the average beat and its marks, and single beats
  5. Charts and Distributions: each reading over the take, and how its values spread

Steadiness

  1. Steadiness: What It Is For, the Toolbar and Info: the nine views, the Info panel, what the tests read and how sure they are
  2. Readings Over Time: every reading in order, its levels and two states
  3. Periods: what the readings repeat at, matched to the wheels
  4. Cycle: one repeat’s shape and size
  5. Autocorrelation: whether each reading follows the last
  6. Allan Deviation: how the scatter of an average changes as it gets longer
  7. CUSUM and Change Points: whether the level changed, and when
  8. FFT: the size of every period’s swing over the whole take
  9. STFT Map: each period’s size through the take, in 20-minute windows
  10. Wavelet Map: where and when each swing is, sharply

Tests and History

  1. Isochronism: the rate at each amplitude, as the curve or the walk
  2. Positions Test: the six positions, guided, and full wind against 24 hours
  3. Power Reserve Test: how long a full wind lasts, hour by hour
  4. The Watches View: your watches, their details and every take
  5. Takes and Sound Files: keeping, opening and what is in a take
  6. Settings and Calibres: General, the Watches folder, and Manage Calibres

How the Numbers Are Made

Each page says what a measure is, how it is computed, why it is done that way, when you’d use it, what it helps find, and what it can’t tell you.

Beyond the App

  1. The Command Line: every command, its options, and its JSON (JavaScript Object Notation) output for scripts and agents
  2. Claude Desktop: the timegrapher in an AI (artificial intelligence) chat app, what it can do and what it never does
  3. Problems and Reports: Report a Problem, the log and crash records, and a window that won’t open
  4. Glossary: the words this guide uses

Other Documents