aboutsummaryrefslogtreecommitdiffstats
path: root/docs/feature_wpm.md
blob: 12dd08057985a90b7cf776aa739ddc1e9fb3366d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# Word Per Minute (WPM) Calculcation

The WPM feature uses time between keystrokes to compute a rolling average words
per minute rate and makes this available for various uses.

Enable the WPM system by adding this to your `rules.mk`:

    WPM_ENABLE = yes

For split keyboards using soft serial, the computed WPM
score will be available on the master AND slave half.

## Public Functions

`uint8_t get_current_wpm(void);`
This function returns the current WPM as an unsigned integer.


## Customized keys for WPM calc

By default, the WPM score only includes letters, numbers, space and some
punctuation.  If you want to change the set of characters considered as part of
the WPM calculation, you can implement `wpm_keycode_user(uint16_t keycode)`
and return true for any characters you would like included in the calculation,
or false to not count that particular keycode.