Using i3

config

# This file has been auto-generated by i3-config-wizard(1).
# It will not be overwritten, so edit it as you like.
#
# Should you change your keyboard layout some time, delete
# this file and re-run i3-config-wizard(1).
#

# i3 config file (v4)
#
# Please see http://i3wm.org/docs/userguide.html for a complete reference!

set $mod Mod4

# Font for window titles. Will also be used by the bar unless a different font
# is used in the bar {} block below.
#font pango:monospace 12

# This font is widely installed, provides lots of unicode glyphs, right-to-left
# text rendering and scalability on retina/hidpi displays (thanks to pango).
#font pango:DejaVu Sans Mono 8
font pango:Source Code Pro 10

# Before i3 v4.8, we used to recommend this one as the default:
# font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
# The font above is very space-efficient, that is, it looks good, sharp and
# clear in small sizes. However, its unicode glyph coverage is limited, the old
# X core fonts rendering does not support right-to-left and this being a bitmap
# font, it doesn’t scale on retina/hidpi displays.

# Use Mouse+$mod to drag floating windows to their wanted position
floating_modifier $mod

# start a terminal
#bindsym $mod+Return exec i3-sensible-terminal
bindsym $mod+Return exec xterm

# kill focused window
bindsym $mod+Shift+q kill

# start dmenu (a program launcher)
bindsym $mod+d exec dmenu_run
# There also is the (new) i3-dmenu-desktop which only displays applications
# shipping a .desktop file. It is a wrapper around dmenu, so you need that
# installed.
# bindsym $mod+d exec --no-startup-id i3-dmenu-desktop

# change focus
bindsym $mod+h focus left
bindsym $mod+j focus down
bindsym $mod+k focus up
bindsym $mod+l focus right

# alternatively, you can use the cursor keys:
bindsym $mod+Left focus left
bindsym $mod+Down focus down
bindsym $mod+Up focus up
bindsym $mod+Right focus right

# move focused window
bindsym $mod+Shift+h move left
bindsym $mod+Shift+j move down
bindsym $mod+Shift+k move up
bindsym $mod+Shift+l move right

# alternatively, you can use the cursor keys:
bindsym $mod+Shift+Left move left
bindsym $mod+Shift+Down move down
bindsym $mod+Shift+Up move up
bindsym $mod+Shift+Right move right

# previous next workspaces
#bindsym $mod+Control+j workspace next
#bindsym $mod+Control+k workspace prev

# split in horizontal orientation
bindsym $mod+b split h

# split in vertical orientation
bindsym $mod+v split v

# enter fullscreen mode for the focused container
bindsym $mod+f fullscreen toggle

# change container layout (stacked, tabbed, toggle split)
bindsym $mod+s layout stacking
bindsym $mod+w layout tabbed
bindsym $mod+e layout toggle split

# toggle tiling / floating
bindsym $mod+Shift+space floating toggle

# change focus between tiling / floating windows
bindsym $mod+space focus mode_toggle

# focus the parent container
bindsym $mod+a focus parent

# focus the child container
#bindsym $mod+d focus child

# switch to workspace
bindsym $mod+1 workspace 1
bindsym $mod+2 workspace 2
bindsym $mod+3 workspace 3
bindsym $mod+4 workspace 4
bindsym $mod+5 workspace 5
bindsym $mod+6 workspace 6
bindsym $mod+7 workspace 7
bindsym $mod+8 workspace 8
bindsym $mod+9 workspace 9
bindsym $mod+0 workspace 10

# move focused container to workspace
bindsym $mod+Shift+1 move container to workspace 1
bindsym $mod+Shift+2 move container to workspace 2
bindsym $mod+Shift+3 move container to workspace 3
bindsym $mod+Shift+4 move container to workspace 4
bindsym $mod+Shift+5 move container to workspace 5
bindsym $mod+Shift+6 move container to workspace 6
bindsym $mod+Shift+7 move container to workspace 7
bindsym $mod+Shift+8 move container to workspace 8
bindsym $mod+Shift+9 move container to workspace 9
bindsym $mod+Shift+0 move container to workspace 10

bindsym $mod+Shift+o move workspace to output right
bindsym $mod+o move container to output right
bindsym $mod+Control+j focus output right

workspace_auto_back_and_forth yes

bindsym $mod+x [urgent=latest] focus

# reload the configuration file
bindsym $mod+Shift+c reload
# restart i3 inplace (preserves your layout/session, can be used to upgrade i3)
bindsym $mod+Shift+r restart
# exit i3 (logs you out of your X session)
bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -b 'Yes, exit i3' 'i3-msg exit'"

# resize window (you can also use the mouse for that)
mode "resize" {
        # These bindings trigger as soon as you enter the resize mode

        # Pressing left will shrink the window’s width.
        # Pressing right will grow the window’s width.
        # Pressing up will shrink the window’s height.
        # Pressing down will grow the window’s height.
        bindsym h resize shrink width 10 px or 10 ppt
        bindsym j resize grow height 10 px or 10 ppt
        bindsym k resize shrink height 10 px or 10 ppt
        bindsym l resize grow width 10 px or 10 ppt

        # same bindings, but for the arrow keys
        bindsym Left resize shrink width 10 px or 10 ppt
        bindsym Down resize grow height 10 px or 10 ppt
        bindsym Up resize shrink height 10 px or 10 ppt
        bindsym Right resize grow width 10 px or 10 ppt

        # back to normal: Enter or Escape
        bindsym Return mode "default"
        bindsym Escape mode "default"
}

bindsym $mod+r mode "resize"

# Start i3bar to display a workspace bar (plus the system information i3status
# finds out, if available)
bar {
  status_command i3status
}

# various stuff to start on load
exec --no-startup-id nm-applet
exec --no-startup-id xsetroot -solid "#002244"

config.default

# This file has been auto-generated by i3-config-wizard(1).
# It will not be overwritten, so edit it as you like.
#
# Should you change your keyboard layout some time, delete
# this file and re-run i3-config-wizard(1).
#

# i3 config file (v4)
#
# Please see http://i3wm.org/docs/userguide.html for a complete reference!

set $mod Mod1

# Font for window titles. Will also be used by the bar unless a different font
# is used in the bar {} block below.
font pango:monospace 8

# This font is widely installed, provides lots of unicode glyphs, right-to-left
# text rendering and scalability on retina/hidpi displays (thanks to pango).
#font pango:DejaVu Sans Mono 8

# Before i3 v4.8, we used to recommend this one as the default:
# font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
# The font above is very space-efficient, that is, it looks good, sharp and
# clear in small sizes. However, its unicode glyph coverage is limited, the old
# X core fonts rendering does not support right-to-left and this being a bitmap
# font, it doesn’t scale on retina/hidpi displays.

# Use Mouse+$mod to drag floating windows to their wanted position
floating_modifier $mod

# start a terminal
bindsym $mod+Return exec i3-sensible-terminal

# kill focused window
bindsym $mod+Shift+q kill

# start dmenu (a program launcher)
bindsym $mod+d exec dmenu_run
# There also is the (new) i3-dmenu-desktop which only displays applications
# shipping a .desktop file. It is a wrapper around dmenu, so you need that
# installed.
# bindsym $mod+d exec --no-startup-id i3-dmenu-desktop

# change focus
bindsym $mod+j focus left
bindsym $mod+k focus down
bindsym $mod+l focus up
bindsym $mod+semicolon focus right

# alternatively, you can use the cursor keys:
bindsym $mod+Left focus left
bindsym $mod+Down focus down
bindsym $mod+Up focus up
bindsym $mod+Right focus right

# move focused window
bindsym $mod+Shift+j move left
bindsym $mod+Shift+k move down
bindsym $mod+Shift+l move up
bindsym $mod+Shift+semicolon move right

# alternatively, you can use the cursor keys:
bindsym $mod+Shift+Left move left
bindsym $mod+Shift+Down move down
bindsym $mod+Shift+Up move up
bindsym $mod+Shift+Right move right

# split in horizontal orientation
bindsym $mod+h split h

# split in vertical orientation
bindsym $mod+v split v

# enter fullscreen mode for the focused container
bindsym $mod+f fullscreen toggle

# change container layout (stacked, tabbed, toggle split)
bindsym $mod+s layout stacking
bindsym $mod+w layout tabbed
bindsym $mod+e layout toggle split

# toggle tiling / floating
bindsym $mod+Shift+space floating toggle

# change focus between tiling / floating windows
bindsym $mod+space focus mode_toggle

# focus the parent container
bindsym $mod+a focus parent

# focus the child container
#bindsym $mod+d focus child

# switch to workspace
bindsym $mod+1 workspace 1
bindsym $mod+2 workspace 2
bindsym $mod+3 workspace 3
bindsym $mod+4 workspace 4
bindsym $mod+5 workspace 5
bindsym $mod+6 workspace 6
bindsym $mod+7 workspace 7
bindsym $mod+8 workspace 8
bindsym $mod+9 workspace 9
bindsym $mod+0 workspace 10

# move focused container to workspace
bindsym $mod+Shift+1 move container to workspace 1
bindsym $mod+Shift+2 move container to workspace 2
bindsym $mod+Shift+3 move container to workspace 3
bindsym $mod+Shift+4 move container to workspace 4
bindsym $mod+Shift+5 move container to workspace 5
bindsym $mod+Shift+6 move container to workspace 6
bindsym $mod+Shift+7 move container to workspace 7
bindsym $mod+Shift+8 move container to workspace 8
bindsym $mod+Shift+9 move container to workspace 9
bindsym $mod+Shift+0 move container to workspace 10

# reload the configuration file
bindsym $mod+Shift+c reload
# restart i3 inplace (preserves your layout/session, can be used to upgrade i3)
bindsym $mod+Shift+r restart
# exit i3 (logs you out of your X session)
bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -b 'Yes, exit i3' 'i3-msg exit'"

# resize window (you can also use the mouse for that)
mode "resize" {
        # These bindings trigger as soon as you enter the resize mode

        # Pressing left will shrink the window’s width.
        # Pressing right will grow the window’s width.
        # Pressing up will shrink the window’s height.
        # Pressing down will grow the window’s height.
        bindsym j resize shrink width 10 px or 10 ppt
        bindsym k resize grow height 10 px or 10 ppt
        bindsym l resize shrink height 10 px or 10 ppt
        bindsym semicolon resize grow width 10 px or 10 ppt

        # same bindings, but for the arrow keys
        bindsym Left resize shrink width 10 px or 10 ppt
        bindsym Down resize grow height 10 px or 10 ppt
        bindsym Up resize shrink height 10 px or 10 ppt
        bindsym Right resize grow width 10 px or 10 ppt

        # back to normal: Enter or Escape
        bindsym Return mode "default"
        bindsym Escape mode "default"
}

bindsym $mod+r mode "resize"

# Start i3bar to display a workspace bar (plus the system information i3status
# finds out, if available)
bar {
        status_command i3status
}

Reference Card.html

<!DOCTYPE html>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<title>i3 Reference Card</title>
	<link rel="stylesheet" href="refcard_style.css" />
	<style type="text/css">
		* { margin: 0; padding: 0; vertical-align: middle; }
		html { font-family: LinuxLibertine, Linux Libertine O, Linux Libertine, serif; font-size: 15px; /* column-count: 3; column-gap: 10px; -moz-column-count: 3; -moz-column-gap: 10px; -webkit-column-count: 3; -webkit-column-gap: 10px; */ }
		body > div { display: inline-block; width: 33%; margin: 0.25%; vertical-align: top; }
		body > div:first-child { margin-left: 0; }
		body > div:last-child { margin-right: 0; }
		#logo { float: left; width: 40px; margin: 7px; }
		header { font-size: 1.1em; text-align: center; }
		h1 { font-size: 1.1em; }
		header a { font-size: 0.7em; }
		header p { margin: 5px 0; font-size: 0.8em; text-align: left; }
		kbd { font-family: LinuxBiolinumKeyboard, Linux Biolinum Keyboard O, Linux Biolinum Keyboard, DejaVu Sans Mono, monospace; font-size: 0.9em; }
		code { font-family: DejaVu Sans Mono, monospace; font-size: 0.8em; }
		section { break-inside: avoid-column; -moz-break-inside: -moz-avoid-column; -webkit-break-inside: avoid-column; }
		h2 { margin: 7px 0 2px; padding: 2px 4px; font-size: 1.1em; font-family: LinuxBiolinum, Linux Biolinum O, Linux Biolinum, sans; background-color: #b3b3b3; }
		table { width: 100%; }
		.i3mod { width: 15px; }
		td:last-child { text-align: right; }
		.ref { font-size: 0.8em; }
		#copyright { margin: 20px 0 15px; font-size: 0.7em; text-align: center; }
		#licence { max-width: 70%; margin: 3px auto; font-size: 0.6em; text-align: right; }
	</style>
	<style type="text/css" media="print">
		html { font-size: 13px; }
	</style>
</head>
<body><div>
	<header>
		<img id="logo" src="logo-30.png" alt="" />
		<h1>i3 Reference Card</h1>
		<a href="http://i3wm.org/docs/userguide.html">http://i3wm.org/docs/userguide.html</a>
		<p>
			Throughout this guide, the i3 logo will be used to refer to the configured modifier.
			This is the <kbd></kbd> key (<code>Mod1</code>) by default,
			with super/<kbd></kbd> (<code>Mod4</code>) being a popular alternative.
		</p>
	</header>


	<section>
	<h2>Basics</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd>
			<td>open new terminal
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>j</kbd>
			<td>focus left

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>k</kbd>
			<td>focus down

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>l</kbd>
			<td>focus up

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>;</kbd>
			<td>focus right
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd>
			<td>toggle focus mode
	</table>
	</section>

	<section>
	<h2>Moving windows</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>j</kbd>
			<td>move window left
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>k</kbd>
			<td>move window down
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>l</kbd>
			<td>move window up
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>;</kbd>
			<td>move window right
	</table>
	</section>

</div><div>

	<section>
	<h2>Modifying windows</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>f</kbd>
			<td>toggle fullscreen
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>v</kbd>
			<td>split a window vertically
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>h</kbd>
			<td>split a window horizontally
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>r</kbd>
			<td>resize mode
	</table>
	<p class="ref">Look at the “Resizing containers / windows” section of the user guide.</p>
	</section>

	<section>
	<h2>Changing the container layout</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>e</kbd>
			<td>default

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>s</kbd>
			<td>stacking

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>w</kbd>
			<td>tabbed
	</table>
	</section>

	<section>
	<h2>Floating</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd></kbd>
			<td>toggle floating
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd>
			<td>drag floating
	</table>
	</section>


	<section>
	<h2>Using workspaces</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>0</kbd>-<kbd>9</kbd>
			<td>switch to another workspace
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>0</kbd>-<kbd>9</kbd>
			<td>move a window to another workspace
	</table>
	</section>

</div><div>

	<section>
	<h2>Opening applications / Closing windows</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd>d</kbd>
			<td>open application launcher (dmenu)
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>q</kbd>
			<td>kill a window
	</table>
	</section>

	<section>
	<h2>Restart / Exit</h2>
	<table>
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>c</kbd>
                        <td>reload the configuration file
		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>r</kbd>
			<td>restart i3 inplace

		<tr>
			<td><img class="i3mod" src="logo-30.png" alt="" /> + <kbd></kbd> + <kbd>e</kbd>
                        <td>exit i3
	</section>
	</table>


	<!-- footer -->
	<p id="copyright">
		Copyright © 2012, Michael Stapelberg
		<br />
		All rights reserved
		<br />
		Designed by Zeus Panchenko, updated by Moritz Bandemer
	</p>
	<p id="licence">
		Permission is granted to copy, distribute and/or modify this document provided
		the copyright notice and this permission notice are preserved on all copies.
	</p>
</div></body>
</html>

Using i3.md

• Introductory Screencast
• How to install on Ubuntu Desktop
• Reference Card (This copy)
• Documentation