i3-migrate-config-to-v4(1)

i3-migrate-config-to-v41

Migrates your i3 config file

Usage

mv ~/.i3/config ~/.i3/old.config

i3-migrate-config-to-v4 ~/.i3/old.config > ~/.i3/config

Overview

i3-migrate-config-to-v4 is a Perl script which migrates your old (< version 4) configuration files to a version 4 config file. The most significant changes are the new commands (see the release notes).

This script will automatically be run by i3 when it detects an old config file. Please migrate your config file as soon as possible. We plan to include this script in all i3 release until 2012-08-01. Afterwards, old config files will no longer be supported.

Releases

8 releases since Debian 7 (Wheezy); the text changed 7 times.

  1. 7
  2. 8
  3. 9
  4. 10
  5. 11
  6. 12
  7. 13
  8. Arch

Author

Michael Stapelberg and contributors

From i3-wm 4.25.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.