gtyper

README

gtyper

ttyper inspired clone

Report

Keypresses Report View

Time Series Report View

At the end of each session you'll see:

• Adjusted WPM — Correct characters typed divided by 5, divided by elapsed minutes.
• Raw WPM — All keypresses (including errors) divided by 5, divided by elapsed minutes.
• Accuracy — Correct keypresses as a percentage of total keypresses.
• Correct Keys — Correct keypresses out of total keypresses (e.g. 272/284).
• Worst Keys — Up to 5 characters with the lowest per-key accuracy.
• Chart — Rolling 10-keypress WPM plotted over the course of the session.

Install

Shell

curl

sh -c "$(curl -fsSL https://raw.githubusercontent.com/mikegetz/gtyper/main/tools/install.sh)"

wget

sh -c "$(wget -qO- https://raw.githubusercontent.com/mikegetz/gtyper/main/tools/install.sh)"

Usage

After installing, launch from your terminal:

gtyper

By default, gtyper fetches a random passage from Project Gutenberg and uses it as the prompt. Pass -o to use offline prompts instead:

gtyper -o

Type the displayed prompt as accurately and quickly as possible. When finished, a results screen shows your stats. Press r to restart or esc to quit.

Custom Prompts

You can supply your own prompts via a config file at ~/.config/gtyper/config.json (or $XDG_CONFIG_HOME/gtyper/config.json). When present and valid, your prompts replace the built-in set entirely. If the file is missing or malformed, gtyper falls back to the built-in prompts silently.

Format — a JSON array of objects:

[
  {
    "content": "The sky above the port was the color of television, tuned to a dead channel.",
    "citation": "— Neuromancer, William Gibson"
  },
  {
    "content": "It was a bright cold day in April, and the clocks were striking thirteen.",
    "citation": "— 1984, George Orwell"
  }
]

• content — required. The text to type.
• citation — optional. Shown in the report overview as the prompt source.

Prompts

Opening passages from classic novels:

• A Tale of Two Cities — Charles Dickens
• Moby-Dick — Herman Melville
• Pride and Prejudice — Jane Austen
• Neuromancer — William Gibson
• The Hobbit — J.R.R. Tolkien
• 1984 — George Orwell
• The Great Gatsby — F. Scott Fitzgerald
• Anna Karenina — Leo Tolstoy
• The Old Man and the Sea — Ernest Hemingway
• East of Eden — John Steinbeck
• Ulysses — James Joyce
• To Kill a Mockingbird — Harper Lee
• The Sun Also Rises — Ernest Hemingway
• Brave New World — Aldous Huxley
• One Hundred Years of Solitude — Gabriel Garcia Marquez
• The Trial — Franz Kafka
• The Color Purple — Alice Walker