Skip to content

Qtile Configuration

Credits go to Shendisx for making this Qtile setup.

X11 and Wayland session

Most of the key combinations require the use of the mod key which in our case is the Windows key (referenced as SUPER), you can change it on the config file. Some of them might make use of mod1 (ALT key).

  • SUPER + Return
  • SUPER + Q
  • SUPER + 1-9 (Number row, number pad does not count)
  • ALT + Space
  • SUPER + H (Left)
  • SUPER + L (Right)
  • SUPER + J (Down)
  • SUPER + K (Up)
  • SUPER + Space (Move windows between left/right columns or move up/down in current stack)

Move focused window to (Left,Right,Down,Up)

Section titled “Move focused window to (Left,Right,Down,Up)”
  • SUPER + Shift + H (Left)
  • SUPER + Shift + L (Right)
  • SUPER + Shift + J (Down)
  • SUPER + Shift + K (Up)

Grow focused window to (Left,Right,Down,Up)

Section titled “Grow focused window to (Left,Right,Down,Up)”
  • SUPER + Control + H (Left)
  • SUPER + Control + L (Right)
  • SUPER + Control + J (Down)
  • SUPER + Control + K (Up)

Reset all window sizes of current workspace to their original size

Section titled “Reset all window sizes of current workspace to their original size”
  • SUPER + N
  • SUPER + F
  • SUPER + V

Toggle between split and unsplit sides of stack

Section titled “Toggle between split and unsplit sides of stack”
  • SUPER + Shift + Return
  • SUPER + TAB
  • SUPER + Control + R
  • SUPER + Control + Q

Execute Flameshot (Utility for taking screenshots)

Section titled “Execute Flameshot (Utility for taking screenshots)”
  • Print

Capture a full-screen screenshot (Saved in $HOME/Pictures)

Section titled “Capture a full-screen screenshot (Saved in $HOME/Pictures)”
  • Control + Print
  • SUPER + E

Drag a floating window around with your mouse

Section titled “Drag a floating window around with your mouse”
  • SUPER + Left Click
  • SUPER + Right Click
  • SUPER + Scroll wheel button

Stick window (For example sticking Firefox PIP will now follow you between workspaces)

Section titled “Stick window (For example sticking Firefox PIP will now follow you between workspaces)”
  • SUPER + S

Why is the volume widget showing an error or it’s stuck at 0%?

Section titled “Why is the volume widget showing an error or it’s stuck at 0%?”
  • Its located in scripts/ from Qtile folder

Does Qtile’s bar interacts with the mouse?

Section titled “Does Qtile’s bar interacts with the mouse?”
  • It does, for example if you scroll on the tiny dots which are your workspaces (Active,Inactive,Empty etc) you’ll switch to the Left or Right or even click in one of them.
  • Another example is the layout (columns by default), clicking on it allows you to switch between the available layouts
  • CPU and RAM usage by clicking it’s going to open Btop (TUI System Monitor)
  • Increase/Lower/Mute/ by interacting on the volume widget

For more information about Qtile. Please check out their wiki for reference.