Apps
| Bind | Action |
|---|---|
Mod+Space | App launcher (Esc closes it) |
Mod+Return | Terminal (foot, fish) |
Mod+w | Web browser (Brave Origin) |
Mod+f | Files (Thunar) |
Mod+e | Editor (Geany) |
Mod+r | Music / radio (Spore) |
Mod+t | Torrents (tuber) |
Mod+n | Network (Wi‑Fi) |
Mod+i | Installer (live ISO) |
Window / layout
| Bind | Action |
|---|---|
Mod+q | Close window |
Mod+m | Toggle column 100% ↔ 50% |
Mod+Shift+f | Fullscreen |
Mod+a | Floating toggle |
Mod+b / Mod+v | Split horizontal / vertical |
Mod+Shift+a | Focus parent |
Mod+h / j / k | Focus left / down / up |
Mod+Left / Right | Focus left / right |
Mod+Shift+h / j / k / l | Move window (vim keys) |
Mod+Shift+arrows | Move window |
Mod+drag | Move floating window |
Mod+right-drag | Resize floating window |
Workspaces / overview
| Bind | Action |
|---|---|
Mod+Tab | Overview (desktop stripes, all windows) |
click / Esc | Leave overview (click focuses that window/desktop) |
Mod+Up / Down | Workspace above / below (exits overview) |
Mod+Ctrl+Up / Down | Move window to workspace above / below |
Mod+1…0 | Workspace 1–10 (exits overview) |
Mod+Shift+1…0 | Move window to workspace 1–10 |
Displays / look
| Bind | Action |
|---|---|
Mod+Ctrl+w | Wallpaper |
Mod+Ctrl+l | Laniakea |
Mod+Ctrl+t | SweetPotato themer |
Mod+Ctrl+g | Corners and gaps |
Mod+Ctrl+d | Displays (nwg-displays) |
Mod+Ctrl+b | Smart Brightness (toggle; fullscreen video → max) |
System
| Bind | Action |
|---|---|
Mod+l | Lock |
Mod+c | Caffeine (idle lock off) |
Mod+Shift+c | Reload config |
Mod+Shift+e | Exit Swirl |
Mod+Esc | Power menu |
Mod+Shift+r | Resize mode |
Mod+? | Keybind cheatsheet (toggle) |
Screenshots / media keys
| Bind | Action |
|---|---|
Print | Screenshot (full) |
Mod+Shift+Print | Screenshot (region) |
Mod+Print | Screen record toggle |
| XF86 audio keys | Volume / mute / mic / media |
| XF86 brightness | Brightness up / down |
Gestures
| Gesture | Action |
|---|---|
| 3-finger L/R | Scroll the window strip |
| 4-finger up/down | Next / previous workspace |
Resize mode
After Mod+Shift+r:
| Key | Action |
|---|---|
h j k l or arrows | Resize focused window |
Enter / Esc | Leave resize mode |
Customize
Edit ~/.config/swirl/config.d/user, then Mod+Shift+c
(survives updates; later binds win over defaults).
See custom Swirl config on the home page.
Desktop / package updates
| Command | Note |
|---|---|
sudo sweetpotatos-update | Update the desktop |
sweetpotatos-pruning | Reset shipped desktop config after experiments go wrong (keeps config.d/user and kanshi; clears user_edits) |
A notice appears once a week when updates are ready.
After an update, a note says what changed.
Run pruning as your user, then Mod+Shift+c if Swirl did not reload.