RELEASE-NOTES-next

 ┌──────────────────────────────┐
 │ Release notes for i3 v4.20   │
 └──────────────────────────────┘

This is i3 v4.20. This version is considered stable. All users of i3 are
strongly encouraged to upgrade.

Background/wallpaper workaround:

Some login managers (e.g. gdm) start the X11 server with the -background none
flag. When this flag is set, a background needs to be explicitly set later in
the X11 session, otherwise stale copies of closed windows remain visible on the
X11 root window (symptom looks like “my terminal window is not closing”).

i3 works around this situation by setting a screenshot as background when
starting. Any background you set before starting i3 (e.g. in your Xsession) or
after starting i3 (e.g. via exec statements in the i3 config) will be visible.

A downside of this workaround is that if you have any windows already open in
your X11 session, those will be part of the screenshot.

To fix this issue, starting in v4.20, i3 detects whether the -background none
option is enabled and only then sets a screenshot as background.


 ┌────────────────────────────┐
 │ Changes in i3 v4.20        │
 └────────────────────────────┘

  • default config: use dex for XDG autostart
  • docs/ipc: document scratchpad_state
  • ipc: the GET_CONFIG request now returns all included files and their details
  • i3-nagbar: position on focused monitor by default
  • i3-nagbar: add option to position on primary monitor
  • alternate focusing tab/stack children-parent containers by clicking on their titlebars
  • i3bar: use first bar config by default
  • i3-dmenu-desktop: ignore duplicate files and directories (fixes crash on NixOS)
  • i3-dump-log -f now uses UNIX sockets instead of pthreads. The UNIX socket approach
    should be more reliable and also more portable.
  • Implement the include config directive
  • Implement optionally showing window icons in titlebar
  • Allow for_window to match against WM_CLIENT_MACHINE
  • Add %machine placeholder (WM_CLIENT_MACHINE) to title_format
  • Allow multiple output names in 'move container|workspace to output'
  • Add 'move container|workspace to output next'
  • Add 'all' window matching criterion
  • Acquire the WM_Sn selection when starting as required by ICCCM
  • Add --replace command line argument to replace an existing WM
  • Notify systemd when i3 is ready, allowing other services to use i3 as a dependency

 ┌────────────────────────────┐
 │ Bugfixes                   │
 └────────────────────────────┘

  • when initializing new outputs, avoid duplicating workspace numbers
  • fix workspaces not moving to assigned output after output becomes available
  • fix duplicate bindcode after i3-config-wizard
  • i3bar: properly close file descriptors
  • i3bar: properly restart status command after config change
  • i3bar: exit with 1 when a wrong command line argument is used
  • fix commented-out rofi call in default i3 config
  • clear pixmap before drawing to prevent visual garbage
  • ipc: return proper signed int for container positions: negative values were
    returned as large 32 bits integers
  • fix crash with "layout default"
  • send an "output" event on XRandR 1.5 monitor configuration change