i3-config-wizard1
Creates a keysym based config based on your layout
Usage
i3-config-wizard [-s
socket]
[-m
modifier]
[-v]
[-h]
Options
-
-s, --socket socket -
Overwrites the path to the i3 IPC socket.
-
-m, --modifier modifier -
Generates the configuration file headlessly. Accepts win or alt.
-
-v, --version -
Display version number and exit.
-
-h, --help -
Display a short help message and exit.
Files
/etc/i3/config.keycodes
This file contains the default configuration with keycodes. All the bindcode lines will be transformed to bindsym and the user-specified modifier will be used.
Overview
i3-config-wizard is started by i3 in its default config, unless ~/.i3/config exists. i3-config-wizard creates a keysym based i3 config file (based on /etc/i3/config.keycodes) in ~/.i3/config.
The advantage of using keysyms is that the config file is easy to read, understand and modify. However, if we shipped with a keysym based default config file, the key positions would not be consistent across different keyboard layouts (take for example the homerow for movement). Therefore, we ship with a keycode based default config and let the wizard transform it according to your current keyboard layout.
Releases
8 releases since Debian 7 (Wheezy); the text changed 7 times.
--help since Debian 10 (Buster);
--modifier since Debian 10 (Buster);
--socket since Debian 10 (Buster);
--version since Debian 10 (Buster);
-h since Debian 10 (Buster);
-m since Debian 10 (Buster);
-s since Debian 10 (Buster);
-v since Debian 10 (Buster).