summaryrefslogtreecommitdiff
path: root/keyboards/nullbitsco/snap/keymaps/typehud/readme.md
blob: d5f50f310c80278883be8693a0bcd259bb9a3619 (plain)
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# Typehud Keymap

VIA compatible keymap that displays a live wpm HUD on your OLED.

<https://nullbits.co/static/file/snap-typehud.webp>

## Configuration

Configuration options (other than the keymap itself) can be found in `typehud/config.h`.

### Graph Type

By default the graph is filled. For a non-filled graph remove or comment out the following line:

```c
#define TYPEHUD_FILLGRAPH
```

### Keyboard Matrix Orientation

To change the keyboard matrix orientation add one of the following:

- `TYPEHUD_MATRIX_ROTATE_90`
- `TYPEHUD_MATRIX_ROTATE_180`
- `TYPEHUD_MATRIX_ROTATE_270`

### Keyboard Matrix Key Overrides

If the number of physical keys doesn't match the keyboard matrix rows/columns you can override it:

```c
#define TYPEHUD_MATRIX_ROWS 6
#define TYPEHUD_MATRIX_COLS 16
```

In addition if the position of the physical keys doesn't match the matrix you can override it. Negative numbers will shift the keys left/up and positive numbers will shift the keys right/down:

```c
#define TYPEHUD_MATRIX_ROW_SHIFT -1
#define TYPEHUD_MATRIX_COL_SHIFT -2
```

### Split Keyboard Side

For split keyboards, the keymap assumes it will be rendered to the slave side.

To render to master instead, add the following configuration line:

```c
#define TYPEHUD_MASTER
```