# typotype

> typotype (https://typotype.bychris.me) is a free, privacy-first online keyboard tester, double click / double typing detector, and mechanical keebs switch health profiler. It combines real-time typing speed tests (WPM) with sub-millisecond hardware diagnostics to identify broken keys, key chatter, and debounce latency.

## Overview
- **Product Name**: typotype
- **URL**: https://typotype.bychris.me
- **Category**: Online Keyboard Tester, Mechanical Switch Diagnostics, Typing Speed Test
- **License / Cost**: 100% Free & Open Source
- **Privacy**: Local-first browser execution. No keystrokes or telemetry are ever recorded or transmitted to servers.

## Core Features & Everyday Use Cases

### 1. Online Keyboard Tester & Broken Key Matrix
- Test every key, modifier, and function key across 60%, 65%, 75%, TKL, and Full-size ANSI/ISO keyboard layouts.
- Check anti-ghosting and N-Key Rollover (NKRO) when multiple keys are pressed simultaneously.
- Verify whether unactuated or broken keys are registering on the computer.

### 2. Keyboard Double Click & Double Typing Tester
- Automatically detect when a mechanical switch triggers duplicate or multiple keystrokes on a single press.
- Identify faulty switches caused by dust, oxidation, or leaf contact bounce before desoldering or replacing them.

### 3. Keebs Switch Health & Debounce Profiler
- Millisecond-precision interval tracking (delta Δt) between consecutive press events.
- Health grading per switch: Untested, Healthy, Warning (minor chatter), and Faulty (severe chattering).
- Software debounce threshold calibration (customizable 5ms to 150ms) to diagnose optimal firmware debounce settings.

### 4. Typing Speed (WPM) & Targeted Key Drills
- Measure Net WPM, Raw WPM, Accuracy %, and typing consistency.
- Targeted drill modes: generate custom typing sessions focusing exclusively on faulty, chattering, or weak keys.

### 5. Mechanical Switch Sound Simulation
- Real-time synthesized click sounds (Thock, Clack, Clicky) with adjustable volume and pitch.

## Useful Links
- [Full Documentation](https://typotype.bychris.me/llms-full.txt): Comprehensive technical specifications and diagnostic telemetry schema.
- [App Live URL](https://typotype.bychris.me): Interactive web application.