---
name: "gen_keymap"
section: "1"
platform: "linux"
package: "keymapper"
version: "0.6.4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gen_keymap"
---

# gen\_keymap(1)

generate a keyboard map decision tree

## NAME

**gen\_keymap** – generate a keyboard map decision tree

## SYNOPSIS

**gen\_keymap** *list* *...*

## DESCRIPTION

**gen\_keymap** generates a decision tree from a set of keyboard maps which can be used to help a user decide which keyboard map to use. The program using the decision tree typically asks the user to press some keys; at each step, it examines the returned keycode and uses it to prune the list of possible keyboard maps until there is only one left.

## OPTIONS

- **-****-version**

  Show program's version number and exit.

- **-**?, **-****-help**

  Show help text.

- **-v**, **-****-verbose**

  Be more verbose.

- **-m***MINLEN*, **-****-minlen**=*MINLEN*

  Too-short keymaps are skipped (default: 30 entries).

- **-g**, **-****-graph**

  Generate a hopefully-nice-looking .dot file.

- **-****-maps**

  Print the to-be-processed keymaps

- **-i**, **-****-installer**

  Input files are in d-i map form.

- **-I***DIRS*, **-****-inc**=*DIRS*, **-****-include**=*DIRS*

  Add a directory to the search path.

- **-o***FILENAME*, **-****-output**=*FILENAME*

  Set output file (default: stdout).

- **-f***FILTER*, **-****-filter**=*FILTER*

  Include only the branches leading to these keymaps.

- **-u***USEONLY*, **-****-useonly**=*USEONLY*

  Start generating the tree based only on these keymaps. (The difference between **-****-filter** and **-****-useonly** is that the former generates the whole tree and then prunes it, while the latter only generates a reduced tree to begin with. This may have implications for performance on large trees.)

- **-s***SKIP*, **-****-skip**=*SKIP*

  Keymaps to skip.

- **-t**, **-****-test**

  Test the generated maps.

- **-****-interactive**

  Ask user to choose among indistinguishable keymaps.

## AUTHORS

**gen\_keymap** was written by Matthias Urlichs ⟨smurf@debian.org⟩. This manual page was written by Colin Watson ⟨cjwatson@ubuntu.com⟩.