2.5 KiB
Ferese handbook
Ferese combines a window manager and desktop shell with one configuration. This handbook covers installation, settings and desktop controls.
Browse screenshots to see the themes, layouts and desktop controls in use.
Get started
- Install Ferese, or try a nested preview.
- Choose Light, Dark, or Auto in Control Center. Open Settings for theme files and presets.
- Use the configuration reference for shortcuts, gestures, window rules, and displays.
Default shortcuts
Use Super, usually the Windows key, for the shortcuts below, and make them your own in
Settings → Shortcuts.
| Control | Action |
|---|---|
| Super + Enter | Open a terminal |
| Super + H / J / K / L | Focus left / down / up / right |
| Super + F | Maximize the window |
| Super + Shift + F | Toggle fullscreen |
| Super + Tab | Open overview |
| Super + M | Switch scrolling / tree layout |
| Print Screen | Capture the active monitor and open Satty |
| Super + Shift + S | Select a screenshot area |
| Super + Shift + E | Ask to log out |
| Super + left-button drag | Move a floating window |
| Super + right-button drag | Resize a floating window |
| Three-finger swipe up / down | Next / previous workspace |
| Three-finger swipe left / right | Focus the window to the right / left |
| Login shortcut guide | Appears at login; disable in Settings → Shortcuts |
The shortcuts and mouse actions guide covers the rest, including how to group windows, resize them and move between workspaces.
Desktop guides
- Lock screen: appearance, automatic locking, and display sleep.
- Screen sharing and recording: share an app or display, or save a video.
- Desktop portals: integration with applications.
Configure the desktop in Settings or edit ~/.config/ferese/config.kdl directly.
Changes apply live. Invalid edits leave the last working configuration in place.
Troubleshooting
If you need to end a session, feresectl request-logout asks for confirmation and
feresectl exit exits immediately, so save your work first. The logs and recovery
guide helps when something stops responding.
To report a problem, include the steps to reproduce it, relevant logs and whether you were using a nested preview or a direct session. See Development to contribute.