git.sur5r.net Git - i3/i3/blob - man/i3-config-wizard.man

   1 i3-config-wizard(1)
   2 ===================
   3 Michael Stapelberg <michael+i3@stapelberg.de>
   4 v4.0, July 2011
   5
   6 == NAME
   7
   8 i3-config-wizard - creates a keysym based config based on your layout
   9
  10 == SYNOPSIS
  11
  12 i3-config-wizard [*-s* 'socket'] [*-m* 'modifier'] [*-v*] [*-h*]
  13
  14 == OPTIONS
  15
  16 *-s, --socket* 'socket'::
  17 Overwrites the path to the i3 IPC socket.
  18
  19 *-m, --modifier* 'modifier'::
  20 Generates the configuration file headlessly. Accepts win or alt.
  21
  22 *-v, --version*::
  23 Display version number and exit.
  24
  25 *-h, --help*::
  26 Display a short help message and exit.
  27
  28 == FILES
  29
  30 === /etc/i3/config.keycodes
  31
  32 This file contains the default configuration with keycodes. All the bindcode
  33 lines will be transformed to bindsym and the user-specified modifier will be
  34 used.
  35
  36 == DESCRIPTION
  37
  38 i3-config-wizard is started by i3 in its default config, unless ~/.i3/config
  39 exists. i3-config-wizard creates a keysym based i3 config file (based on
  40 /etc/i3/config.keycodes) in ~/.i3/config.
  41
  42 The advantage of using keysyms is that the config file is easy to read,
  43 understand and modify. However, if we shipped with a keysym based default
  44 config file, the key positions would not be consistent across different
  45 keyboard layouts (take for example the homerow for movement). Therefore, we
  46 ship with a keycode based default config and let the wizard transform it
  47 according to your current keyboard layout.
  48
  49 == SEE ALSO
  50
  51 i3(1)
  52
  53 == AUTHOR
  54
  55 Michael Stapelberg and contributors