0xTsoa
←/

i3 Tiling Classic

▲ 0✓
01. Overview & Architecture02. Installation & Deployment03. Screenshot Gallery04. Documentation & Guide05. Keyboard Shortcuts

01. Overview & Architecture

Profile: 4.25.1
Schema validatedSource pinned
Purpose
The iconic, rock-solid X11 tiling window manager designed for speed and clarity.
Compatibility
Debian, Ubuntu, Arch Linux, Fedora, Void Linux, Linux Mint (Server: X11)
Desktop Part
WM & compositors
Window Manager & Theme
i3 / Classic Engineering Monochrome
Key Components
Bar:i3bar / i3status•Terminal:Xterm / Alacritty•Launcher:Dmenu•Notifications:Dunst•Editor:Vim•Shell:bash
Full Description
The golden standard of manual tiling window managers. i3 is lightweight, extremely well-documented, clean, and runs reliably on any Linux distribution without needing composite GPU drivers.

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
Origingithub.com/i3/i3Pinned to be04c853ee7f · reviewed in this config file
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: i3, i3status, dmenu, alacritty, dunstWrites: ~/.config/i3/config
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: back up first (Option A, step 3).
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/i3/i3 ~/0xtsoa-review/i3-i3-tiling# 1. clone to a review folder
$git -C ~/0xtsoa-review/i3-i3-tiling checkout --detach be04c853ee7fa01a82a0c81f8217565395e2627c# 2. the reviewed commit
$for p in ~/.config/i3/config; do [ -e "$p" ] && cp -a "$p" "$p.bak-0xtsoa"; done# 3. back up what the steps write
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install i3 package suite
$sudo apt install i3 i3status dmenu alacritty dunst
2Initialize ~/.config/i3/config
$mkdir -p ~/.config/i3
$cp /etc/i3/config ~/.config/i3/config
3In-place restart of i3
$i3-msg restart
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/i3/i3-tiling/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // i3 Tiling Classic

Capture 01 // Fullscreen
i3 desktop with clean window tiling and gaps
01 / 03

04. Documentation & Guide

Source: i3/i3Ref: be04c853ee
README.md|GitHub Flavored Markdown
RawSource ↗

Logo i3: A tiling window manager

![Build Status](https://github.com/i3/i3/actions/workflows/main.yml/badge.svg) ![Issue Stats](https://img.shields.io/github/issues/i3/i3.svg) ![Pull Request Stats](https://img.shields.io/github/issues-pr/i3/i3.svg)

![Packages](https://repology.org/badge/latest-versions/i3.svg) ![Packages](https://repology.org/badge/tiny-repos/i3.svg)

i3 is a tiling window manager for X11.

For more information about i3, please see the project's website and online documentation.

For information about contributing to i3, please see CONTRIBUTING.md.

GitHub Flavored Markdown (github-markdown-css)README snapshot at be04c853ee

05. Keyboard Shortcuts

Total: 4 shortcuts
SUPER + RETURNShortcut
exec, alacritty
Open terminal
SUPER + DShortcut
exec, dmenu_run
Launch application menu
SUPER + SHIFT + QShortcut
kill
Kill window
SUPER + SHIFT + RShortcut
restart
Restart i3 in place