-Welcome to i3,
-This message is simply intended to introduce you to the basics of i3 with it's default configuration.
-For further details have a look at the man page or the User's Guide which you can find at:
-http://i3.zekjur.net/docs/userguide.html
+1.) Welcome to i3!
+This message provides an overview of the default keybindings to use i3.
+Please also make sure to have a look at the man page and the user's guide:
+http://i3wm.org/docs/userguide.html
-Configuration Files
-/etc/i3/config is the default configuration
-~/.i3/config is your configuration, it's recommended to copy the default one to this file and modify it.
+2.) Configuration Files
-Keybindings for the first steps
-The following explanation is related to the QWERTY layout, but as the default configuration uses
-keycodes instead of keysymbols for binding, they're still the same keys even with another layout.
-The Mod1 key is usually bound to the Alt key at your keyboard.
+/etc/i3/config is the default configuration. It is recommended to copy it and
+afterwards edit it to suit your needs (in particular, you may want to disable
+this message):
-Mod1+Enter opens a terminal which is by default urxvt
+ cp /etc/i3/config ~/.i3/config
-Mod1+v starts dmenu
-The directional keys are by default j(left), k(down), l(up) and ;(right).
+3.) Keybindings
-Mod1+<directional key> moves the focus to the window in the given direction
+The following explanation is related to the QWERTY layout, but as the default
+configuration uses keycodes instead of keysymbols for binding, you still have
+to press the same physical keys, regardless of your keyboard layout.
-Mod1+Shift+<directional key> moves the window to the given direction, containers are created on the fly
+The Mod1 key is usually bound to the "Alt" key on your keyboard.
-Mod1+<number> opens the corresponding workspace
+Mod1+Enter opens a terminal emulator
+Mod1+v starts dmenu (an application launcher)
-Mod1+Shift+<number> moves a window to the wished workspace
+The directional keys are j(left), k(down), l(up) and ;(right). You can also use
+the arrow keys on your keyboard, if you prefer them.
+Mod1+<directional key> moves the focus to the window in the given direction
+Mod1+Shift+<directional key> moves the window to the given direction
+Mod1+<number> opens the corresponding workspace
+Mod1+Shift+<number> moves a window to the selected workspace
Mod1+h sets the mode of a container to stacking
-
Mod1+e sets the mode back to default
-
-Mod1+f sets a window to fullscreen and also back to default mode
-
-Mod1+Shift+Space sets a window into floating mode or back into tiling mode
-
+Mod1+f toggles fullscreen mode for the current window
+Mod1+Shift+Space toggles floating mode for the current window
Mod1+Shift+q closes a window
-
-Mod1+Shift+r restarts i3
-
+Mod1+Shift+r restarts i3 in-place (at this time, you will lose your layout)
Mod1+Shift+e exits i3
-
-For detailed information about the configuration file syntax, the keybindings which weren't mentioned
-here and other features take a look at the User's Guide and the man page.
-
+If you have any questions, please don't hesitate to ask!
+Have fun using i3
projects / i3 / i3 / blobdiff