Skip to content

dakra/speed-type

Repository files navigation

speed-type melpa badge melpa stable badge

Practice touch/speed typing in GNU Emacs.

Screenshot

Installation

Install speed-type from MELPA with:

M-x package-install RET speed-type

If you prefer to install by hand: Put speed-type.el into a directory specified by the load-path variable. Alternatively, you can add a directory to the variable load-path by (add-to-list 'load-path "ADDITIONAL-DIRECTORY").

If you put the file in "~/.emacs.d/speed-type/speed-type.el" for instance, the following snipped in your .emacs file will load and init the extension.

(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.

Customization

See all custom variables of speed-type pressing:

M-x customize-group speed-type RET

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)

The default of speed-type-add-extra-words-on-mistake is 0 which means no additional words are added on misstyping. If you like to challange yourself you can set this to a number higher than 0. A number between 1 and 7 is recommanded.

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.