Installing on Ubuntu or Debian

Newer versions of Debian-based distros (Debian >= 13, Ubuntu >= 25.04) have Qtile packages. Exact versions for each distro release can be found either on packages.debian.org or packages.ubuntu.com

Older Releases

Ubuntu and Debian >=11 comes with the necessary packages for installing Qtile. Starting from a minimal Debian installation, the following packages are required:

sudo apt install xserver-xorg xinit
sudo apt install libpangocairo-1.0-0
sudo apt install python3-pip python3-xcffib python3-cairocffi

Either Qtile can then be downloaded from the package index or the Github repository can be used, see Installing From Source:

pip install qtile