termtype — Deep Strategy Guide

Overview

termtype is a terminal-based typing game where words fall like Space Invaders. Type them correctly before they hit the water line. Miss too many, and you drown. It's pure-keyboard, runs entirely in your terminal, and uses the asciimatics library for rendering. No GUI, no mouse, no distraction.

Built by GiovanniCst and released under the MIT license, termtype launched at version 0.2.0 and has 49 commits of active development. It ships with three distinct game modes, four word packs, persistent stat tracking with sparkline charts, a badge system, chiptune audio, and a local leaderboard.

Target audience: Typing enthusiasts, CLI lovers, anyone who wants to improve typing speed in an engaging format. Fans of Epistory, Typing of the Dead, or old-school typing tutors who want something with actual game mechanics.

Difficulty: Vocab mode scales from beginner-friendly (slow drops, short words) to punishing (six simultaneous long words dropping at high speed). Story mode depends on the source text — public-domain books vary from simple prose to dense Victorian vocabulary. Hacker News mode is unpredictable because headline length varies wildly.

---

Getting Started — Installation and First Run

Installation

termtype isn't on PyPI yet, so installation is from source:

git clone https://github.com/GiovanniCst/termtype.git
cd termtype
python3.11 -m venv .venv
source .venv/bin/activate
pip install -e .

On Windows (PowerShell), create the venv with the Windows Python:

py -3.11 -m venv .venv
.\\.venv\\Scripts\\python.exe -m pip install -e .
.\\.venv\\Scripts\\termtype.exe

Audio tip: Under WSL, the sound bridge can crackle. Run natively on Windows for clean audio. On Linux/macOS, audio works out of the box.

If your terminal mangles visuals: Run termtype --ascii to force the no-Unicode renderer. This is common on Windows Console (use Windows Terminal instead) or exotic terminal emulators.

First Launch

The main menu shows four options:

1. Vocab — Endless arcade mode. Words fall, you type, waves escalate.
2. Story — Type through public-domain books in order. Progress saves automatically.
3. Hacker News — Type live HN front-page headlines (offline fallback: all-time top posts).
4. Settings — Word pack selection, audio toggle, profile management.

Create a profile immediately. Stats tracking, sparklines, and leaderboards only work with a profile. The game creates a SQLite database at ~/.termtype/termtype.db — your data never leaves your machine.

Start with Vocab mode on Easy. The difficulty curve is gentler than jumping straight into Story mode with a dense chapter from a 19th-century novel.

---

Core Mechanics

How the Fall System Works

Words spawn at the top of the terminal and descend at a set speed. When you start typing a word, it becomes "locked" — its color changes, and only that word accepts input until you complete it or abort with double Backspace.

Each word has a "drop speed" stat determined by the current wave level. Higher waves increase:

• Fall speed (pixels per tick)
• Simultaneous words (how many on screen at once)
• Word length (shorter words are easier)
• Special characters (punctuation, numbers, symbols)

The Water Line

At the bottom of the screen is a visual water line. When a word crosses this line, you lose one life. The game starts with 5 lives. Lose all 5, and the game ends.

Critical detail: The water line isn't a hard floor. Words that cross it still exist for ~0.5 seconds before they "drown." If you finish typing the word during this grace window, it counts as a save. Top players exploit this half-second for clutch saves on long words they started late.

Combo System

Each correct word adds to your combo counter. The combo multiplies your score for that word:

Dropping a word (it crosses the water line) resets the combo to 0. Aborting a word (double Backspace) does NOT reset the combo — use this strategically.

Scoring Breakdown

---

Progression Strategy — Three Modes, Three Approaches

Vocab Mode — The Training Ground

Vocab mode is endless. Waves escalate indefinitely. The goal is survival and high score.

Wave structure:

Strategy: In waves 1–5, your goal isn't just to survive. Build a 50+ combo streak here while words are easy. The multiplier carries forward. A single missed word in wave 3 that resets your 40-streak combo costs you thousands of potential points in later waves.

Story Mode — The Endurance Test

Story mode types through public-domain books in order. You can choose Zen mode (no pressure, type at your own pace) or Challenge mode (lives matter).

Available books (order):

1. Alice's Adventures in Wonderland — Lewis Carroll (simpler vocabulary, good for warming up)
2. Pride and Prejudice — Jane Austen (denser, formal English)
3. The Adventures of Sherlock Holmes — Arthur Conan Doyle (varied vocabulary, dialogue-heavy)
4. Moby Dick — Herman Melville (complex prose, technical whaling terminology)
5. War and Peace — Leo Tolstoy (translation — long sentences, character names)

Story mode tip: The game saves your progress within each book. Quit anytime with S (Save & Quit). Resume exactly where you left off. Use this to tackle long books in 15-minute sessions.

Challenge mode optimization: When you hit unfamiliar words (Victorian-era vocabulary like "chophouse" or "perambulator"), double-Backspace immediately to abort the word. The -0.5s penalty from aborting is better than the 3s penalty of letting it drown. Plus, aborting preserves your combo.

Hacker News Mode — Real-World Training

Fetches live headlines from the Hacker News API. Headlines are unpredictable — you'll type "Show HN: I built a thing in Rust" one moment and "The case for Lisp macros" the next.

Offline fallback: If you're not connected, it uses a cached set of all-time top HN posts. These tend to be longer and more technical.

This is the best mode for practical typing practice. HN headlines use real-world capitalization, punctuation, and character length variation that's more relevant to daily typing than prose excerpts.

---

Builds / Practice Regimens

The Speed Runner (Vocab Score Attack)

Drill: Load Vocab mode with programming word pack. Programming terms ("asynchronous", "initialization", "polymorphism") are the longest in the game. Master these, and standard English words feel easy.

The Accuracy Specialist (Story Challenge Mode)

Drill: Read ahead. In Story mode, the next ~10 words are displayed at the top of the screen. Train your peripheral vision to pre-read while your fingers handle the current word.

The All-Rounder (Mixed Routine)

Week 1: 15 minutes Vocab + 15 minutes Story (Zen) daily. Week 2: 10 minutes Vocab + 10 minutes Story (Challenge) + 10 minutes HN daily. Week 3+: 5 minutes warmup Vocab + 20 minutes Story (Challenge) + 5 minutes HN cooldown.

---

Word Packs — Which to Use When

Switch packs weekly. Muscle memory adapts to frequent letter patterns. The programming pack forces you to type "javascript" (no capital J in word mode) and "asynchronous" — great for breaking out of qwerty ruts.

---

Step-by-Step Strategy Sequences

Sequence 1: Building Your First 50-Combo in Vocab Mode

1. Start Vocab mode on Easy difficulty.
2. Waves 1–2: Type every word without rushing. Focus 100% on accuracy.
3. At wave 3, the game introduces a second simultaneous word. Your instinct will be to type faster. Resist. Type at the same speed — the words are still short.
4. When you hit a 20-streak (wave 4–5), notice the chiptune adds hi-hat. This is your audio cue that the combo is meaningful.
5. Between waves, there's a 2-second grace period. Use it to breathe and recenter.
6. If you're at 45+ streak entering wave 6, the pressure kicks in (3 simultaneous words). Keep your finger hover over Backspace — if you mistype, double-tap to abort. Aborting costs nothing to the combo.
7. Hit 50. You now have the 5x multiplier. Each correct word is worth 500+ points.

Sequence 2: Surviving the Vocab Difficulty Spike (Waves 13–15)

The jump from wave 12 to 13 adds a fourth simultaneous word and increases drop speed by 40%. This spike kills most first-time players.

1. Before wave 13, you get a 3-second "Wave incoming" warning. Scan the word list that appears at the top.
2. Priority order: shortest word first. Short words clear fast, reducing on-screen clutter.
3. If two words are at similar drop levels, type the one with more unique letters. Common letters (e, t, a) are harder to distinguish under pressure.
4. When a word reaches the bottom 20% of the screen, drop everything and type it. One missed word resets your combo. Saving a near-death word preserves the streak.
5. If three words stack at the bottom simultaneously, use the grace period. Type one, let another cross with the 0.5s window, then catch the third.

Sequence 3: Story Mode — Beating Alice in Wonderland on Challenge

1. Set difficulty to Challenge (lives matter). You get 5 lives for the entire book.
2. Chapter 1 ("Down the Rabbit Hole") has simpler language. This is your warmup. Don't lose any lives here.
3. The poem "How Doth the Little Crocodile" appears in Chapter 2. Poems have unusual line breaks and capitalization. Slow down — read the full word before typing.
4. The Caucus Race section (Chapter 3) has dense descriptive prose. This is where most players lose their first life. The vocabulary shifts suddenly: "thimble," "comfits," "dryest."
5. If you reach Chapter 6 (Pig and Pepper) with 4+ lives remaining, you're on track for a clean clear. The Cheshire Cat dialogue uses short, manageable text.
6. The mock turtle's story (Chapter 9) has the longest single word in the book: "Gryphon." It appears multiple times. After the first encounter, you'll recognize it instantly.
7. Final chapter is short. You can clear it with 1 life remaining.

---

Advanced Tips

1. The Peripheral Scan. Most typing games train you to look at the word you're typing. In termtype, train yourself to look at the middle of the screen while the current word registers in peripheral vision. This lets you see all falling words simultaneously. Practice this for 2 minutes per session — after a week it becomes automatic.

2. Abort Discipline. Double-Backspace is free. If you start typing a word and realize it's "incomprehensibilities" rather than "incomprehensible" (yes, this is a real word), abort immediately. The fraction of a second you waste finishing the wrong word costs more than the abort + restart.

3. Rhythmic Breathing. When the combo hits 30+ and words are falling fast, most players hold their breath. This causes micro-tremors in the fingers. Breathe in for 2 words, out for 2 words. Your accuracy will improve by 5–10%.

4. The 24-Hour Wall. Almost every player hits a plateau at ~60 WPM in Vocab mode wave 10–12. This isn't a skill ceiling — it's a finger-memory recalibration point. Push through for 3 sessions without switching modes. The plateau breaks around session 4.

5. Custom Word Packs. termtype stores word packs as plain text files in the src/termtype/wordpacks/ directory. You can add your own. Create a file with one word per line, restart the game, and it appears in the settings menu. Common custom packs: chemical compounds, medical terminology, programming languages from Wikipedia, your email contacts' names.

6. The --no-audio flag. If you play in a library or office, the chiptune audio can be distracting. Run termtype --no-audio for silent operation. The combo audio feedback is purely cosmetic — losing it doesn't affect gameplay.

7. Dark mode terminals. The game uses a terminal-color-aware palette. On dark backgrounds, words appear in bright colors. On light backgrounds (white terminal), colors invert automatically. If the contrast feels off, switch your terminal theme.

---

FAQ / Common Mistakes

---

System Requirements

No GPU required. No internet required (except Hacker News mode). The game runs on a Raspberry Pi without issues.