diff --git a/Module:-xkeyboard.md b/Module:-xkeyboard.md
new file mode 100644
index 0000000..d1f3f30
--- /dev/null
+++ b/Module:-xkeyboard.md
@@ -0,0 +1,36 @@
+This module shows the current layout and active indicators.
+
+### Basic settings
+~~~ ini
+[module/keyboard]
+type = internal/xkeyboard
+
+; List of indicators to ignore
+blacklist-0 = num lock
+blacklist-1 = scroll lock
+~~~
+
+### Additional formatting
+~~~ ini
+; Available tags:
+;   <label-layout> (default)
+;   <label-indicator> (default)
+format = <label-layout> <label-indicator>
+format-spacing = 0
+
+; Available tokens:
+;   %layout%
+;   %name%
+; Default: %layout%
+label-layout = %name%
+label-layout-padding = 2
+label-layout-background = #bc99ed
+label-layout-foreground = #000
+
+; Available tokens:
+;   %name%
+; Default: %name%
+label-indicator = %name%
+label-indicator-padding = 2
+label-indicator-background = #8139e8
+~~~