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

from libqtile.config import Key, Screen, Group, Drag, Click
from libqtile.command import lazy
from libqtile import layout, bar, widget
    from typing import List  # noqa: F401
except ImportError:
mod = "mod4"
keys = [
    # Switch between windows in current stack pane
    Key([mod], "k", lazy.layout.down()),
    Key([mod], "j", lazy.layout.up()),
    # Move windows up or down in current stack
    Key([mod, "control"], "k", lazy.layout.shuffle_down()),
    Key([mod, "control"], "j", lazy.layout.shuffle_up()),
    # Switch window focus to other pane(s) of stack
    Key([mod], "space", lazy.layout.next()),
    # Swap panes of split stack
    Key([mod, "shift"], "space", lazy.layout.rotate()),
    # Toggle between split and unsplit sides of stack.
    # Split = all windows displayed
    # Unsplit = 1 window displayed, like Max layout, but still with
    # multiple stack panes
    Key([mod, "shift"], "Return", lazy.layout.toggle_split()),
    Key([mod], "Return", lazy.spawn("xterm")),
    # Toggle between different layouts as defined below
    Key([mod], "Tab", lazy.next_layout()),
    Key([mod], "w", lazy.window.kill()),
    Key([mod, "control"], "r", lazy.restart()),
    Key([mod, "control"], "q", lazy.shutdown()),
    Key([mod], "r", lazy.spawncmd()),
groups = [Group(i) for i in "asdfuiop"]
for i in groups:
        # mod1 + letter of group = switch to group
        Key([mod], i.name, lazy.group[i.name].toscreen()),
        # mod1 + shift + letter of group = switch to & move focused window to group
        Key([mod, "shift"], i.name, lazy.window.togroup(i.name)),
layouts = [
widget_defaults = dict(
extension_defaults = widget_defaults.copy()
screens = [
                widget.TextBox("default config", name="default"),
                widget.Clock(format='%Y-%m-%d %a %I:%M %p'),
# Drag floating layouts.
mouse = [
    Drag([mod], "Button1", lazy.window.set_position_floating(),
    Drag([mod], "Button3", lazy.window.set_size_floating(),
    Click([mod], "Button2", lazy.window.bring_to_front())
dgroups_key_binder = None
dgroups_app_rules = []  # type: List
main = None
follow_mouse_focus = True
bring_front_click = False
cursor_warp = False
floating_layout = layout.Floating(float_rules=[
    {'wmclass': 'confirm'},
    {'wmclass': 'dialog'},
    {'wmclass': 'download'},
    {'wmclass': 'error'},
    {'wmclass': 'file_progress'},
    {'wmclass': 'notification'},
    {'wmclass': 'splash'},
    {'wmclass': 'toolbar'},
    {'wmclass': 'confirmreset'},  # gitk
    {'wmclass': 'makebranch'},  # gitk
    {'wmclass': 'maketag'},  # gitk
    {'wname': 'branchdialog'},  # gitk
    {'wname': 'pinentry'},  # GPG key password entry
    {'wmclass': 'ssh-askpass'},  # ssh-askpass
auto_fullscreen = True
focus_on_window_activation = "smart"
# XXX: Gasp! We're lying here. In fact, nobody really uses or cares about this
# string besides java UI toolkits; you can see several discussions on the
# mailing lists, github issues, and other WM documentation that suggest setting
# this string if your java app doesn't work correctly. We may as well just lie
# and say that we're a working one by default.
# We choose LG3D to maximize irony: it is a 3D non-reparenting WM written in
# java that happens to be on java's whitelist.
wmname = "LG3D"
dpi_scale = 1.0
View more configuration examples on Github

Benefits of using a tiling window manager

Optimize your workflow by configuring your environment to fit how you work.
Efficiently use screen real-estate by automatically arranging windows with minimal visual cruft.
Save your wrists from RSI by ditching the mouse and driving with the keyboard.

Why Qtile?

Qtile is simple, small, and extensible. It's easy to write your own layouts, widgets, and built-in commands.
Qtile is written and configured entirely in Python. Leverage the full power and flexibility of the language to make it fit your needs.
The Qtile community is active and growing. There's always someone to lend a hand when you need help.
Qtile is free and open-source software. Distributed under the permissive MIT license .

The Qtile community

Two dialogue boxes which means comment sections. IRC Channel


Two dialogue boxes which meants comments section. Mailing list


Two dialogue boxes which meants comments section. Twitter


Getting involved

Two dialogue boxes which meants comments section. Issue tracker

Report bugs and request new features

Two dialogue boxes which meants comments section. Hacking Qtile

Get started hacking on the code