git.sur5r.net Git - i3/i3/blob - docs/userguide

   1 i3 User’s Guide
   2 ===============
   3 Michael Stapelberg <michael+i3@stapelberg.de>
   4 May 2009
   5
   6 This document contains all information you need to configuring and using the i3 window
   7 manager. If it does not, please contact me on IRC, Jabber or E-Mail and I’ll help you out.
   8
   9 == Configuring i3
  10
  11 TODO: document the other options, implement variables before
  12
  13 terminal::
  14         Specifies the terminal emulator program you prefer. It will be started by default when
  15         you press Mod1+Enter, but you can overwrite this. Refer to it as +$terminal+ to keep things
  16         modular.
  17 font::
  18         Specifies the default font you want i3 to use. Use an X core font descriptor here, like
  19         +-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1+. You can use +xfontsel(1)+
  20         to pick one.
  21
  22 === Keyboard bindings
  23
  24 TODO
  25
  26 *Syntax*:
  27 --------------------------------
  28 bind [Modifiers+]keycode command
  29 --------------------------------
  30
  31 *Examples*:
  32 --------------------------------
  33 # Fullscreen
  34 bind Mod1+41 f
  35
  36 # Restart
  37 bind Mod1+Shift+27 restart
  38 --------------------------------
  39
  40 === Automatically putting clients on specific workspaces
  41
  42 It is recommended that you match on window classes whereever possible because some applications
  43 first create their window and then care about setting the correct title. Firefox with Vimperator
  44 comes to mind, as the window starts up being named Firefox and only when Vimperator is loaded,
  45 the title changes. As i3 will get the title as soon as the application maps the window (mapping
  46 means actually displaying it on the screen), you’d need to have to match on Firefox in this case.
  47
  48 *Syntax*:
  49 ----------------------------------------------------
  50 assign ["]window class[/window title]["] [→] workspace
  51 ----------------------------------------------------
  52
  53 *Examples*:
  54 ----------------------
  55 assign urxvt 2
  56 assign urxvt → 2
  57 assign "urxvt" → 2
  58 assign "urxvt/VIM" → 3
  59 ----------------------