Go to file
Max Cohen c464a3f46e Add install doc 2022-07-11 14:20:50 +00:00
.github Add Python 3.10 tox env 2021-12-18 16:30:29 +00:00
bin Refactor Qtile LifeCycle 2021-01-04 19:07:06 -07:00
docs Add focused window Match to lazy function's .when() check 2021-12-20 20:40:42 +00:00
libqtile Merge branch 'master' of https://github.com/qtile/qtile into qtile-master 2021-12-23 15:48:59 +01:00
resources resources: add wayland session desktop entry 2021-09-05 20:59:22 +01:00
scripts wephyr script should also use $OUTPUTS under Wayland 2021-06-01 08:25:04 -06:00
stubs Remove redundant stubs 2021-10-12 22:12:11 +01:00
test Add focused window Match to lazy function's .when() check 2021-12-20 20:40:42 +00:00
.coveragerc Adjust coveragerc 2016-05-03 12:00:58 -05:00
.gitignore Add .env to gitignore 2021-05-23 17:45:15 +02:00
.pylintrc CI: Whac-A-Mole: Prevent issues from plopping up again. 2021-03-26 16:31:54 -06:00
CHANGELOG Add place_right option to place the tab panel on the right side (#3127) 2021-12-23 02:03:45 +00:00
CONTRIBUTING.md CONTRIBUTING: add more docs about what we look for in PRs 2021-10-12 09:22:31 +01:00
INSTALL.md Add install doc 2022-07-11 14:20:50 +00:00
LICENSE Add MIT license declaration. 2008-08-08 09:27:46 +10:00
MANIFEST.in libqtile: include a py.typed file 2021-02-13 07:33:55 -07:00
Makefile make: add mypy to lint target 2021-03-07 10:41:50 +01:00
README.rst Revert "Centre align logo and buttons" 2021-10-24 18:06:17 +01:00
config.py Update colors for catppuccin theme 2022-07-10 12:12:57 +02:00
dev.sh tests: port to xcffib's new find_display() api 2020-07-23 08:47:22 -06:00
logo.png Make the README fancier 2019-04-29 19:59:49 -04:00
requirements-dev.txt Fixes for mypy 0.901 2021-06-09 20:15:58 -06:00
requirements.txt Add psutils required for widgets 2022-03-24 17:53:02 +01:00
setup.cfg WL: support foreign toplevel management protocol 2021-12-05 09:49:18 +00:00
setup.py remove already defined `install_requires` from setup.py (#1919) 2020-09-28 12:38:56 +02:00
tox.ini Pin mypy to 0.930 in mypy tox env 2021-12-22 20:01:19 +00:00

README.rst

|logo|

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

|website| |pypi| |ci| |rtd| |license|

Features
========

* 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.

Community
=========

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.

:Mailing List: https://groups.google.com/group/qtile-dev
:IRC: irc://irc.oftc.net:6667/qtile

Contributing
============

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.

.. _`issue tracker`: https://github.com/qtile/qtile/issues
.. _`tips & tricks`: https://docs.qtile.org/en/latest/manual/hacking.html
.. _`guidelines`: https://docs.qtile.org/en/latest/manual/contributing.html

.. |logo| image:: https://raw.githubusercontent.com/qtile/qtile/master/logo.png
    :alt: Logo
    :target: https://www.qtile.org
.. |website| image:: https://img.shields.io/badge/website-qtile.org-blue.svg
    :alt: Website
    :target: https://www.qtile.org
.. |pypi| image:: https://img.shields.io/pypi/v/qtile.svg
    :alt: PyPI
    :target: https://pypi.org/project/qtile/
.. |ci| image:: https://github.com/qtile/qtile/workflows/ci/badge.svg?branch=master
    :alt: CI status
    :target: https://github.com/qtile/qtile/actions
.. |rtd| image:: https://readthedocs.org/projects/qtile/badge/?version=latest
    :alt: Read the Docs
    :target: https://docs.qtile.org/en/latest/
.. |license| image:: https://img.shields.io/github/license/qtile/qtile.svg
    :alt: License
    :target: https://github.com/qtile/qtile/blob/master/LICENSE


Maintainers
===========

| `@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``

.. _`@tych0`: https://github.com/tych0
.. _`@ramnes`: https://github.com/ramnes
.. _`@m-col`: https://github.com/m-col
.. _`@flacjacket`: https://github.com/flacjacket
.. _`@elParaguayo`: https://github.com/elparaguayo