---
title: Qtile Keybinds & FAQ
description: CachyOS Qtile keybinds & FAQ
---

import { Kbd } from 'starlight-kbd/components'

Credits go to [Shendisx](https://github.com/Shendisx) for making this Qtile setup.

> X11 and Wayland session

## Keybinds

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

### Application Control

| Description | Key |
|-------------|-----|
| Open terminal | <Kbd linux="Super+Return" /> |
| Open Rofi (Program launcher) | <Kbd linux="Alt+Space" /> |
| Open file manager (Thunar) | <Kbd linux="Super+E" /> |
| Kill focused window | <Kbd linux="Super+Q" /> |

### Workspace Navigation

| Description | Key |
|-------------|-----|
| Go to workspace (1-9) | <Kbd linux="Super+1" /> through <Kbd linux="Super+9" /> |

### Window Navigation

| Description | Key |
|-------------|-----|
| Move focus left | <Kbd linux="Super+H" /> |
| Move focus right | <Kbd linux="Super+L" /> |
| Move focus down | <Kbd linux="Super+J" /> |
| Move focus up | <Kbd linux="Super+K" /> |
| Move windows between columns or up/down in stack | <Kbd linux="Super+Space" /> |

### Window Management

| Description | Key |
|-------------|-----|
| Move focused window left | <Kbd linux="Super+Shift+H" /> |
| Move focused window right | <Kbd linux="Super+Shift+L" /> |
| Move focused window down | <Kbd linux="Super+Shift+J" /> |
| Move focused window up | <Kbd linux="Super+Shift+K" /> |
| Toggle fullscreen | <Kbd linux="Super+F" /> |
| Toggle floating | <Kbd linux="Super+V" /> |
| Stick window (follow between workspaces) | <Kbd linux="Super+S" /> |

### Window Resizing

| Description | Key |
|-------------|-----|
| Grow focused window left | <Kbd linux="Super+Control+H" /> |
| Grow focused window right | <Kbd linux="Super+Control+L" /> |
| Grow focused window down | <Kbd linux="Super+Control+J" /> |
| Grow focused window up | <Kbd linux="Super+Control+K" /> |
| Reset all window sizes to original | <Kbd linux="Super+N" /> |

### Layout Control

| Description | Key |
|-------------|-----|
| Toggle between split and unsplit sides of stack | <Kbd linux="Super+Shift+Return" /> |
| Toggle between layouts | <Kbd linux="Super+Tab" /> |

### Mouse Controls

| Description | Key |
|-------------|-----|
| Drag floating window | <Kbd linux="Super+Left_Click" /> |
| Resize floating window | <Kbd linux="Super+Right_Click" /> |
| Bring window to front | <Kbd linux="Super+Scroll_Wheel_Button" /> |

### Screenshot

| Description | Key |
|-------------|-----|
| Execute Flameshot (screenshot utility) | <Kbd linux="Print" /> |
| Capture full-screen screenshot (saved in ~/Pictures) | <Kbd linux="Control+Print" /> |

### System Controls

| Description | Key |
|-------------|-----|
| Reload Qtile configuration | <Kbd linux="Super+Control+R" /> |
| Exit Qtile (end X session) | <Kbd linux="Super+Control+Q" /> |
## FAQ

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

* This is sometimes due to the Qtile volume widget not being able to detect your default Output Device. You can [take a look in the wiki](https://docs.qtile.org/en/latest/manual/ref/widgets.html#pulsevolume) for more information.

### Is there a autostart.sh script?

* Yes, it's located in `scripts/` from Qtile folder.

### Does Qtile's bar interact 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](https://docs.qtile.org/en/stable/).
