Use the September 30 hero on the website and README, add a shared screenshot gallery, and remove the old showcase images. Build image links locally and clean generated site output. Back up the known development portal override during installation and report custom overrides before building. Keep source selections clear while letting blur show through unselected rows.
2.5 KiB
Ferese handbook
Ferese is a Linux Wayland desktop with scrolling columns, tree tiling, floating windows, and a shared theme for its desktop tools.
Browse screenshots of the desktop, themes and shell controls.
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
Super is usually the Windows key. All these shortcuts can be changed in Settings.
| 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 |
See all shortcuts and mouse actions, including Super-drag to move and Super-right-drag to resize floating windows.
Desktop guides
- Desktop widgets: clocks and sticky notes.
- Notifications: history and Do Not Disturb.
- 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.
Use Settings or edit ~/.config/ferese/config.kdl. Changes reload automatically;
invalid edits keep the last working configuration.
Troubleshooting
See logs and recovery. feresectl exit
ends the session immediately; feresectl request-logout asks for confirmation.
Report problems in the issue tracker. Include reproduction steps, whether Ferese ran as a nested preview or a direct session, and relevant logs. Contributors can start with Development.