Samuel Onoja
65fcaef13f
* Integrate panel composition, adaptive sizing, and overflow * Add instance editing controls to panel settings * Add panel group editing and measured composition preview * Reorganize panel settings and add drag-and-drop item editing * Simplify panel settings and place inspectors beside the editor * Refine Panel & Shell settings, previews, and panel rendering * Organize settings navigation and modernize packaged panel config * Support top and bottom panels and refine shell surfaces Add edge-aware settings, previews, popup placement, notifications, margins, and corner rendering. Preserve translucency in notification and dialog controls, and tighten spacing around the clock and display-mode icon. * Add workspace styles and fix Settings text rendering * Make panel allocation independent of measurement order * Normalize panel item settings and visibility * Move shell geometry into each panel * Add independent group surfaces and finalize panel configuration * Keep panel fit checks and restoration consistent with allocation * Reject unknown panel item options and namespace metadata * Reject invalid shell startup configuration and remove old radius fields * Discover workspace application icons in a background task * Remove the panel architecture document and improve reference prose * Let panel media fill available space and improve Settings scrolling * Preserve panel labels across clipped GPU rendering * Use matching alpine lake wallpapers for light and dark modes * Fix panel accessibility and popup lifecycle Apply Reduce Transparency to panel opacity in the shell, compositor, and Settings preview. Reject unknown theme tokens before snapshot substitution and validate the current geometry fields in both consumers. Dismiss popovers and workspace tooltips after panel layout changes. Handle bar pointer exits directly and recover workspace hover after reentry without repeated motion updates. Cover the transitions with regression tests and update the wallpaper dimensions check for the bundled lake defaults. * Use tagged Ferese toolkit fixes * Fix center-only panel spacing and headless text rendering * Bundle native 4K abstract wallpapers for both appearances * Dismiss workspace tooltips before captured pointer dispatch * Verify installed JPEG wallpapers when replacing a release
59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# Ferese handbook
|
|
|
|
Ferese combines a window manager and desktop shell with one configuration.
|
|
This handbook covers installation, settings and desktop controls.
|
|
|
|
[Browse screenshots](screenshots.md) to see the themes, layouts and desktop controls in
|
|
use.
|
|
|
|
## Get started
|
|
|
|
1. [Install Ferese](installation.md), or try a [nested preview](installation.md#preview-and-logs).
|
|
2. Choose Light, Dark, or Auto in **Control Center**. Open **Settings** for theme files and presets.
|
|
3. Use the [configuration reference](configuration.md) 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 → Keyboard & mouse → 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 → Keyboard & mouse → Shortcuts |
|
|
|
|
The [shortcuts and mouse actions guide](shortcuts.md) covers the rest, including how to
|
|
group windows, resize them and move between workspaces.
|
|
|
|
## Desktop guides
|
|
|
|
- [Lock screen](locking.md): appearance, automatic locking, and display sleep.
|
|
- [Screen sharing and recording](screen-sharing.md): share an app or display, or save a video.
|
|
- [Desktop portals](portals.md): integration with applications.
|
|
- [Animation model](animation-model.md): spring motion, geometry ownership, and resize presentation.
|
|
|
|
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](installation.md#logout-and-recovery) helps when something stops responding.
|
|
|
|
To [report a problem](https://github.com/ferese-wm/ferese/issues), include the steps to
|
|
reproduce it, relevant logs and whether you were using a nested preview or a direct
|
|
session. See [Development](development.md) to contribute.
|