i3 is a tiling window manager for X11 that organizes your screen like a dynamic grid, giving you precise control over window placement without sacrificing speed. Instead of overlapping windows, i3 arranges them side by side or stacked, which frees screen space and reduces clutter. This guide explains how to use i3, from basic setup to advanced workflows, so you can turn your desktop into a focused and efficient workspace.
Getting Started with i3
To begin using i3, install it through your distribution package manager and select it at the login display manager. Most setups rely on a minimal configuration file located at ~/.config/i3/config, where you define keybindings, gaps, and workspace rules. Because i3 is keyboard driven, learning a handful of default shortcuts lets you control workspaces, split containers, and launch applications without ever touching the mouse.
Understanding the Basic Layout Model
i3 works with containers that can be either horizontal or vertical splits, and each container holds a single window. When you open new windows, i3 arranges them in a tree that automatically adjusts to screen size. You can switch focus between containers, resize them on the fly, and promote a floating window into the layout for a seamless transition between modes.
Default Keybindings You Will Use Daily
Mod + Enter to open a terminal without breaking your workflow.
Mod + Shift + q to close the focused window cleanly.
Mod + j and Mod + k to move focus between vertically arranged containers.
Mod + h and Mod + l to move focus between horizontally arranged containers.
Mod + 1 through Mod + 9 to switch instantly between numbered workspaces.
Workspaces, Marks, and Scratchpads
Workspaces in i3 act as virtual desktops, and you can jump between them instantly to separate projects or contexts. Marks let you tag windows with short labels so you can return to a specific browser tab or editor without cycling through workspaces. Scratchpads provide temporary floating terminals that you can summon with a single keybinding, keeping your main layout untouched for deep focus sessions.
Customizing i3 to Match Your Workflow
You can personalize i3 by adding status bars, custom scripts, and application-specific rules. A status bar displays workspace, battery, and date information, and you can configure it to launch menus or show notifications. Use modifier+Shift+c to reload the configuration safely while you experiment, and define gaps, fonts, and window borders to create a visual style that feels native to your environment.
Practical Configuration Snippets
Productivity Patterns for Long Sessions
Combine workspaces and scratchpads to create a research zone, a coding zone, and a communication zone, each isolated but a keypress away. Assign frequent applications to keys so you can launch them in the correct workspace automatically, and use marks to jump directly to your email client, code editor, or documentation without losing your train of thought.
