speed-type

Practice touch/speed typing in GNU Emacs.

Installation

Install speed-type from MELPA with:

M-x package-install RET speed-type

Or via use-package and straight:

(use-package speed-type
  :straight t)

Alternatively, you can clone this project and add it to the load-path in your init-file:

(add-to-list 'load-path "~/.emacs.d/speed-type/speed-type.el")
(require 'speed-type)

Running speed-type

Executing M-x speed-type-text will start the typing exercise. A new buffer will open and a random text sample will appear. As you type the text it will change color to show progress and highlight correct and incorrect entries. Timing happens automatically, the clock starts on the first character typed and ends with the last. Statistics like characters typed, words-per-minute, and total time will be shown as soon as the last character is entered.

You can use any buffer or part of it to run speed-type. M-x speed-type-region and M-x speed-type-buffer will do the same thing as speed-type-text, except they take the text sample you've picked. This works for programming code buffers/regions as well.

speed-type-buffer by default will only take a random portion of the buffer - If you want the whole buffer, use C-u speed-type-buffer.

Random samples are taken from Project Gutenberg. A small number of books will be downloaded on demand and stored in "~/emacs.d/speed-type". They will only be downloaded once.

speed-type-region will start a speed-type session with the text from the selected region.

speed-type-top-x (or -100/-1000) lets you practice the top X words for the selected language.

speed-type-quote by default will take a random quote from a random quote-url listed in speed-type-quote-urls. You can C-u speed-type-quote to specify the url.

Customization

See all custom variables of speed-type pressing:

M-x customize-group speed-type RET

Customize cursor motion

By default the cursor moves forward with each typed character and marks it green if correct or red otherwise.

If you'd like to stay on the character until it's correctly typed, you can customize the speed-type-point-motion-on-error to point-stay.

Make consecutive errors appear in different color (yellow)

Speed-type differenciate between errors and consecutive-errors.

An error is a mistyped character. A consectuive-error is a mistyped character where previous character was already an error.

You can make consecutive errors yellow/orange (warning-color) by customizing the face as follows:

(face-spec-set 'speed-type-consecutive-error-face '((t :inherit warning :underline t)))

Statistics

The default of speed-type-save-statistic-option is always which means speed-type session data is stored to file speed-type-statistic-filename. All values which you see at the end of each speed-type session are stored there.

You can display the calculated medians from the data by pressing d at the end of a speed-type session.

Add words on error (typer-mode)

There exists two variable for this purpose:

1. speed-type-add-extra-words-on-non-consecutive-errors
2. speed-type-add-extra-words-on-error.

Both have the default 0 which means no addittional words are added. If both are set they accumlate each other.

If you like to challange yourself, it's recommanded to set one of them to a number between 1 and 7.

It adds random or next words from the content the speed-type session was started from. If you replay the session, the added words will be included.