New locale

README.md

@@ -81,6 +81,38 @@ make clean
 
 Removes the binary and the generated `locale/` directory.
 
+## Capturing key sequences
+
+For rows of type **Key**, the action button opens a capture dialog:
+
+- Press keys one after another; each press becomes one step.
+- Modifier keys (Ctrl, Alt, Shift, Super) held during a press are recorded
+  as part of that step.
+- The live preview shows the sequence. `Clear` resets it, `Done` writes it
+  into the row, `Cancel` discards it.
+
+The sequence uses the same format as
+[g910-gkey-macro-support](https://github.com/JSubelj/g910-gkey-macro-support):
+modifiers are joined with `+`, steps are separated with `,`
+(e.g. `ctrl+c,ctrl+v` or `shift+f4,super+t`).
+
+## Configuration format
+
+`Save mappings` writes `~/.config/gKeyMapper/mappings.conf`:
+
+```
+# gKeyMapper mappings (G1..G9)
+G1=key:ctrl+c,ctrl+v
+G2=command:/usr/bin/firefox
+G3=disabled:
+```
+
+The same format is used by Export/Import. `key` holds a captured shortcut
+sequence, `command` a program or file path, `disabled` ignores the G key
+(similar to the `shortcut` / `run` / `nothing` hotkey types of the
+reference project above; a native C++ daemon for G-key detection and
+replay is planned next, no Python involved).
+
 ## Project structure
 
 ```