Changes

Jump to: navigation, search

Package:Qtile

18 bytes removed, 6 years ago
m
Lowered section levels
{{warning|This document does not cover the current qtile ebuild that comes from the Gentoo portage tree. It covers [https://github.com/apinsard/funtoo-overlay/tree/qtile/x11-wm/qtile this ebuild] that will normally be merge to funtoo-overlay soon.}}
=== About Qtile ===
Qtile is a highly configurable tiling window manager distributed under MIT license. It handles both '''tiling and floating''' layouts. It is especially a good alternative to [[Package:Awesome (Window Manager)|Awesome]] for those who are more used to [[Python]] than [[Package:Lua|Lua]]. Indeed, Qtile is written and configured entirely in Python. So whether you are Python guru or whether you are learning Python for a few time, Qtile is an ideal choice to get your environment fit ''your'' needs and feel. If you don't know Python, you can still stuck to the default configuration or pick out one of the [https://github.com/qtile/qtile-examples configuration examples] but a basic understanding of Python language is recommended though.
=== Installation ===
<console>
And run <code>xinit</code> to launch qtile. You can also configure a display manager instead, but this is not covered in this document.
=== Getting Started ===
{{tip|As far as possible, when a default behavior is explained, a link to the related configuration snippet is given so that you can get more information and tweak it as you want.}}
Workspaces are highlighted in [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/widget/groupbox.py#L136 white font] when windows are opened in them (against [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/widget/groupbox.py#L137 gray font] when it contains no window). The current workspace is [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/widget/groupbox.py#L164 surrounded with a blue border], if you have multiple screens, workspaces currently displayed in other screens are [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/widget/groupbox.py#L169 surrounded with a gray border]. You can [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/resources/default_config.py#L90 go to a given workspace pressing <code>Mod4 + <workspace ID></code>] (a, s, d, f, u, i, o or p by default). If you go to a workspace that is already displayed in another screen, workspaces will be swapped. You can [https://github.com/qtile/qtile/blob/v0.9.1/libqtile/resources/default_config.py#L95 move the current window to a given workspace pressing <code>Mod4 + Shift + <workspace ID></code>].
=== Configuration ===
Qtile looks in the following places for a configuration file, in order:
{{warning|Don't forget to replace "v0.9.1" with the version you installed or it may not work.}}
==== Customize bars ====
''Coming soon''
==== Customize workspaces ====
''Coming soon''
==== Startup applications ====
''Coming soon''
==== Use widgets ====
''Coming soon''
==== Configuration examples ====
<div class="row">
wiki-staff
336
edits

Navigation menu