xkbmon

A versatile keyboard layout monitor for X11.

Table of Contents

<!-- vim-markdown-toc GFM -->

• Features
• Examples
  • tmux
  • Tint2
  • dwm
  • i3 with i3blocks
• Build Instructions
  • DEB-based distro
  • RPM-based distro
  • Build & Run
• License

<!-- vim-markdown-toc -->

Features

• real-time monitoring with zero CPU usage
• output layout in lower, upper or camel case
• extra low memory footprint
• zero dependency (only XCB)

Examples

tmux

Add to .tmux.conf:

set -g status-right '#[fg=white]#[bg=blue] #(xkbmon -u) '

Tint2

Add to tint2rc:

-------------------------------------
# Executor 1
execp = new
execp_command = xkbmon -u
execp_interval = 1
execp_has_icon = 0
execp_cache_icon = 1
execp_continuous = 1
execp_markup = 0
execp_font = Sans Bold 9
execp_font_color = #dcdcdc 100
execp_padding = 0 0
execp_background_id = 0
execp_centered = 0

dwm

Add to .xsession

xkbmon -u | while read -r line; do xsetroot -name $line; done &

i3 with i3blocks

Add to i3blocks.conf:

[xkbmon]
command=xkbmon -u
interval=persist
color=#2E9EF4

Build Instructions

DEB-based distro

apt install libxcb-xkb-dev

RPM-based distro

yum install libxcb-devel

Build & Run

make
./xkbmon

License

MIT