:cookie: A full-featured, hackable tiling window manager written and configured in Python (X11 + Wayland)

qtile qtile Last update: May 05, 2023


A full-featured, hackable tiling window manager written and configured in Python

Website PyPI CI status Read the Docs License Codestyle Coverage


  • Simple, small and extensible. It's easy to write your own layouts, widgets and commands.
  • Configured in Python.
  • Runs as an X11 WM or a Wayland compositor.
  • Command shell that allows all aspects of Qtile to be managed and inspected.
  • Complete remote scriptability - write scripts to set up workspaces, manipulate windows, update status bar widgets and more.
  • Qtile's remote scriptability makes it one of the most thoroughly unit-tested window managers around.


Qtile is supported by a dedicated group of users. If you need any help, please don't hesitate to fire off an email to our mailing list or join us on IRC. You can also ask questions on the discussions board.

Mailing List:https://groups.google.com/group/qtile-dev
Discord:https://discord.gg/ehh233wCrC (Bridged with IRC)

Example code

Check out the qtile-examples repo which contains examples of users' configurations, scripts and other useful links.


Please report any suggestions, feature requests, bug reports, or annoyances to the GitHub issue tracker. There are also a few tips & tricks, and guidelines for contributing in the documentation.

Please also consider submitting useful scripts etc. to the qtile-examples repo (see above).


@tych0 GPG: 3CCA B226 289D E016 0C61 BDB4 18D1 8F1B C464 DCA3
@ramnes GPG: 99CC A84E 2C8C 74F3 2E12 AD53 8C17 0207 0803 487A
@m-col GPG: 35D9 2E7C C735 7A81 173E A1C9 74F9 FDD2 0984 FBEC
@flacjacket GPG: 58B5 F350 8339 BFE5 CA93 AC9F 439D 9701 E7EA C588
@elParaguayo GPG: A6BA A1E1 7D26 64AD B97B 2C6F 58A9 AA7C 8672 7DF7
@jwijenbergh GPG: B1C8 1CF3 063B 5836 4946 3687 4827 061B D417 C233

Subscribe to our newsletter