i3/docs/userguide

60 lines
1.8 KiB
Plaintext
Raw Normal View History

i3 Users Guide
===============
Michael Stapelberg <michael+i3@stapelberg.de>
May 2009
This document contains all information you need to configuring and using the i3 window
manager. If it does not, please contact me on IRC, Jabber or E-Mail and Ill help you out.
== Configuring i3
TODO: document the other options, implement variables before
terminal::
Specifies the terminal emulator program you prefer. It will be started by default when
you press Mod1+Enter, but you can overwrite this. Refer to it as +$terminal+ to keep things
modular.
font::
Specifies the default font you want i3 to use. Use an X core font descriptor here, like
+-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1+. You can use +xfontsel(1)+
to pick one.
=== Keyboard bindings
TODO
*Syntax*:
--------------------------------
bind [Modifiers+]keycode command
--------------------------------
*Examples*:
--------------------------------
# Fullscreen
bind Mod1+41 f
# Restart
bind Mod1+Shift+27 restart
--------------------------------
=== Automatically putting clients on specific workspaces
It is recommended that you match on window classes whereever possible because some applications
first create their window and then care about setting the correct title. Firefox with Vimperator
comes to mind, as the window starts up being named Firefox and only when Vimperator is loaded,
the title changes. As i3 will get the title as soon as the application maps the window (mapping
means actually displaying it on the screen), youd need to have to match on Firefox in this case.
*Syntax*:
----------------------------------------------------
assign ["]window class[/window title]["] [→] workspace
----------------------------------------------------
*Examples*:
----------------------
assign urxvt 2
assign urxvt → 2
assign "urxvt" → 2
assign "urxvt/VIM" → 3
----------------------