1I3-CONFIG-WIZARD(1)                i3 Manual               I3-CONFIG-WIZARD(1)
2
3
4

NAME

6       i3-config-wizard - creates a keysym based config based on your layout
7

SYNOPSIS

9       i3-config-wizard [-s socket] [-m modifier] [-v] [-h]
10

OPTIONS

12       -s, --socket socket
13           Overwrites the path to the i3 IPC socket.
14
15       -m, --modifier modifier
16           Generates the configuration file headlessly. Accepts win or alt.
17
18       -v, --version
19           Display version number and exit.
20
21       -h, --help
22           Display a short help message and exit.
23

FILES

25   /etc/i3/config.keycodes
26       This file contains the default configuration with keycodes. All the
27       bindcode lines will be transformed to bindsym and the user-specified
28       modifier will be used.
29

DESCRIPTION

31       i3-config-wizard is started by i3 in its default config, unless
32       ~/.i3/config exists. i3-config-wizard creates a keysym based i3 config
33       file (based on /etc/i3/config.keycodes) in ~/.i3/config.
34
35       The advantage of using keysyms is that the config file is easy to read,
36       understand and modify. However, if we shipped with a keysym based
37       default config file, the key positions would not be consistent across
38       different keyboard layouts (take for example the homerow for movement).
39       Therefore, we ship with a keycode based default config and let the
40       wizard transform it according to your current keyboard layout.
41

SEE ALSO

43       i3(1)
44

AUTHOR

46       Michael Stapelberg and contributors
47
48
49
50i3 4.23                           10/29/2023               I3-CONFIG-WIZARD(1)