Index: src/hid_cfg_input.h
===================================================================
--- src/hid_cfg_input.h	(revision 1453)
+++ src/hid_cfg_input.h	(revision 1454)
@@ -3,12 +3,8 @@
 
 #include <liblihata/dom.h>
 #include <genht/htip.h>
+#include "hid_cfg.h"
 
-typedef struct {
-	lht_node_t *mouse;
-	htip_t *mouse_mask;
-} hid_cfg_mouse_t;
-
 /* For compatibility; TODO: REMOVE */
 #define M_Mod(n)  (1u<<(n+1))
 
@@ -32,7 +28,70 @@
 #define MB_ANY (MB_LEFT | MB_MIDDLE | MB_RIGHT | MB_UP | MB_DOWN)
 #define M_ANY  (M_Release-1)
 
+/************************** MOUSE ***************************/
+
+typedef struct {
+	lht_node_t *mouse;
+	htip_t *mouse_mask;
+} hid_cfg_mouse_t;
+
 int hid_cfg_mouse_init(hid_cfg_t *hr, hid_cfg_mouse_t *mouse);
 void hid_cfg_mouse_action(hid_cfg_mouse_t *mouse, hid_cfg_mod_t button_and_mask);
 
+
+/************************** KEYBOARD ***************************/
+typedef union hid_cfg_keyhash_u { /* integer hash key */
+	unsigned long hash;
+	struct {
+		short int mods;          /* of hid_cfg_mod_t */
+		short int key_char;
+	} details;
+} hid_cfg_keyhash_t;
+
+
+typedef struct hid_cfg_keyseq_s  hid_cfg_keyseq_t;
+struct hid_cfg_keyseq_s {
+	unsigned long int keysym;  /* optional 32 bit long storage the GUI hid should cast to whatever the GUI backend supports */
+
+	lht_node_t *node; /* terminal node: end of sequence, run actions */
+
+	htip_t seq_next; /* ... or if node is NULL, a hash for each key that may follow the current one */
+	hid_cfg_keyseq_t *parent;
+};
+
+/* A complete tree of keyboard shortcuts/hotkeys */
+typedef struct hid_cfg_keys_s {
+	htip_t keys;
+} hid_cfg_keys_t;
+
+
+/* Initialize a new keyboard context 
+   Returns 0 on success.
+*/
+int hid_cfg_keys_init(hid_cfg_keys_t *km);
+
+/* Add a new key using a description (read from a lihata file usually)
+   If out_seq is not NULL, load the array with pointers pointing to each
+   key in the sequence, up to out_seq_len.
+   Returns -1 on failure or the length of the sequence.
+*/
+int hid_cfg_keys_add_by_desc(hid_cfg_keys_t *km, const char *keydesc, hid_cfg_keyseq_t **out_seq, int out_seq_len);
+
+/* Process next input key stroke.
+   Seq and seq_len must not be NULL as they are the internal state of multi-key
+   processing. Load seq array with pointers pointing to each key in the
+   sequence, up to seq_len_max.
+   Returns:
+    -1 if the key stroke or sequence is invalid
+     0 if more characters needed to complete the sequence
+     + a positive integer means the lookup succeeded and the return value
+       is the length of the resulting sequence.
+*/
+int hid_cfg_keys_input(hid_cfg_keys_t *km, hid_cfg_mod_t mod, short int key_char, hid_cfg_keyseq_t **seq, int *seq_len, int seq_len_max);
+
+/* Run the action for a key sequence looked up by hid_cfg_keys_input().
+   Returns: the result of the action or -1 on error */
+int hid_cfg_keys_action(hid_cfg_keyseq_t *seq, int seq_len);
+
+
 #endif