From ArchWiki
Revision as of 19:58, 10 May 2012 by Cfrog (talk | contribs) (Creation of the page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

From Qtile web site:

Qtile is a full-featured, hackable tiling window manager written in Python. Qtile is simple, small, and extensible. It's easy to write your own layouts, widgets, and built-in commands.It is written and configured entirely in Python, which means you can leverage the full power and flexibility of the language to make it fit your needs.


Qtile (git version) is available in the AUR: qtile-gitAUR.

A default configuration file is provided on the git repository. Copy it in ~/.config/qtile/config.py.

An easy way to do this is:

$ mkdir -p ~/.config/qtile/
$ wget https://raw.github.com/qtile/qtile/master/libqtile/resources/default_config.py -o ~/.config/qtile/config.py

Starting Qtile

To start Qtile add exec qtile to your ~/.xinitrc and launch Xorg. The default configuration includes the shortcut Alt+Enter to open a new xterm terminal.


Note: This chapter only explains the basics of the configuration of Qtile. For more complete information, look at the official documentation.

The configuration is fully done in python in the file ~/.config/qtile/config.py. The indentation is very important in python, therefore respect it.

Before restarting Qtile you can test your config file for syntax error with the command:

$ python2 ~/.config/qtile/config.py


In Qtile the workspaces (or views) are called Groups. They can be defined as following for instance:

from libqtile.manager import Group
groups = [


You can configure your shortcuts with the function Key. Here is an example of the shortcut Alt+Shift+q to quit the Windows Manager.

from libqtile.manager import Key
from libqtile.command import lazy
keys = [
        ["shift","mod1"], "q",

You can find out which modX corresponds to which key with the command xmodmap.

Screens and Bars

Create one Screen function for every monitor you have. The bars of Qtile are configured in the Screen function as in the following example:

from libqtile.manager import Screen
from libqtile import bar, widget
screens = [
            ], 30))


You can find information on the widgets in the documentation.

Some of the widgets (such as BatteryIcon and Notify) are not included in the default git repository, but you can download them here and copy them in /usr/lib/python2.7/site-packages/libqtile/widget/.

See Also