aboutsummaryrefslogtreecommitdiff
path: root/keyboards/splitkb/kyria/keymaps/lw/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'keyboards/splitkb/kyria/keymaps/lw/readme.md')
-rw-r--r--keyboards/splitkb/kyria/keymaps/lw/readme.md104
1 files changed, 104 insertions, 0 deletions
diff --git a/keyboards/splitkb/kyria/keymaps/lw/readme.md b/keyboards/splitkb/kyria/keymaps/lw/readme.md
new file mode 100644
index 000000000..67be1950a
--- /dev/null
+++ b/keyboards/splitkb/kyria/keymaps/lw/readme.md
@@ -0,0 +1,104 @@
1# Kyria's lw Keymap
2
3Custom keymap for the [kyria keyboard](https://blog.splitkb.com/blog/introducing-the-kyria). It is intended to be used with an *English (US, intl. with dead keys)* keyboard layout (includes the `keymap_us_international.h` header).
4
5This layout is mainly designed for every day writing in either English, French or German and programming.
6
7The layout implements all accents and symbols (leveraging dead keys) found on a **swiss** keyboard. It uses Unicode for special characters. It makes use of the [Linux built-in IBus Unicode input](https://docs.qmk.fm/#/feature_unicode?id=input-modes) and relies on [WinCompose](https://github.com/samhocevar/wincompose) for Windows.
8
9## Build this keymap
10```bash
11qmk compile -kb splitkb/kyria/rev1 -km lw
12```
13
14## Flash this keymap
15
16> **Note**: this was tested for an Elite-C microcontroller.
17
18First, check that the bootloader is visible. For instance:
19```bash
20$ lsusb
21...
22Bus 001 Device 034: ID 03eb:2ff4 Atmel Corp. atmega32u4 DFU bootloader
23...
24```
25If the bootloader is not visible, press the reset button of the microcontroller. The bootloader should become visible when running the `lsusb` command again.
26
27The microcontroller can now be flashed:
28```bash
29qmk flash -kb splitkb/kyria/rev1 -km lw
30```
31> **Note**: if there is any issue, run `qmk doctor` to see whether the qmk configuration is valid.
32
33## Implemented keymaps
34The default keymap contains 5 layers which allows it to include all keys found on an ANSI layout TKL keyboard plus media keys.
35Hardware features of the Kyria such as OLEDs, rotary encoders and underglow are also supported.
36
37The five different layers are the following:
381. Base layer (QWERTZ)
392. Symbols/Numbers layer
403. Navigation layer
41
42### Base layer
43This layer is activated by default.
44
45```
46/*
47 * 0. Base Layer: QWERTZ
48 *
49 * ,-------------------------------------------. ,-------------------------------------------.
50 * | Esc | Q | W | E | R | T | | Z | U | I | O | P | Del |
51 * |--------+------+------+------+------+------| |------+------+------+------+------+--------|
52 * | Tab | A | S | D | F | G | | H | J | K | L | ' " | BkSpace|
53 * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------|
54 * | LShift | Y | X | C | V | B | \ | | ` ~ | | ( | ) | N | M | , < | . > | ; : | CpLock |
55 * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------'
56 * |LCtrl | LGUI | LAlt | Space| MO(1)| | MO(2)| Enter| - _ | ! | / ? |
57 * | | | | | | | |/shift| | | |
58 * `----------------------------------' `----------------------------------'
59 */
60```
61
62Hold down the `Enter` key to make it a shift. This compensates for the poor placement of the dedicated `LShift` key.
63
64### Symbol layer
65This layer is activated when holding `MO(1)`.
66
67```
68/*
69 * 1. Sym Layer: Numbers and symbols
70 *
71 * ,-------------------------------------------. ,-------------------------------------------.
72 * | F1 | F2 | F3 | F4 | LAlt | PASTE| | , | 7 | 8 | 9 | * | / |
73 * |--------+------+------+------+------+------| |------+------+------+------+------+--------|
74 * | F5 | F6 | F7 | F8 | @ | COPY | | . | 6 | 7 | 8 | = | |
75 * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------|
76 * | F9 | F10 | F11 | F12 | & | CUT | UNDO | FIND | | [ | ] | 0 | 1 | 2 | 3 | + | - |
77 * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------'
78 * | $ | # | % | | MO(1)| | MO(2)| | \ | | { | } |
79 * | | | | | | | | | | | |
80 * `----------------------------------' `----------------------------------'
81 */
82```
83
84### Navigation layer
85This layer is activated when holding `MO(2)`.
86
87```
88/*
89 * 2. Nav Layer: Media, navigation, accents
90 *
91 * ,-------------------------------------------. ,-------------------------------------------.
92 * | | Brt+ | Next | Fwd | Play | Vol+ | | Home | PgUp | Up | PgDn | | Del |
93 * |--------+------+------+------+------+------| |------+------+------+------+------+--------|
94 * | | Brt- | Prev | Bckw | Stop | Vol- | | End | Left | Down | Right|ScrLck| BkSpace|
95 * |--------+------+------+------+------+------+-------------. ,-------------+------+------+------+------+------+--------|
96 * | LShift | ´ | ` | ^ | ¨ | Mute | |UC_MOD| |RShift| Menu | PrtSc| ç/Ç | § ° | | SAVE | Insert |
97 * `----------------------+------+------+------+------+------| |------+------+------+------+------+----------------------'
98 * |LCtrl | LGUI | LAlt | | MO(1)| | MO(2)| UNDO | CUT | COPY | PASTE|
99 * | | | | | | | | | | | |
100 * `----------------------------------' `----------------------------------'
101 */
102```
103
104The key `UC_MOD` allows to switch between Linux and Windows unicode. Note however that [WinCompose](https://github.com/samhocevar/wincompose) must be installed on Windows (simply download and install the latest release and it will run). \ No newline at end of file