Samuel Onoja
3d950a0411
Resolve light, dark and automatic appearance centrally and publish live theme snapshots to native surfaces and the appearance portal. Add paired preset families, custom theme imports, accessibility transforms and contrast-safe transitions. Refine the Settings gallery and Auto controls, move overrides under advanced customization, and share palette-aware switches and circular slider thumbs. Document configuration and include theme licenses and integration coverage.
55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# Ferese handbook
|
|
|
|
Ferese is a Linux Wayland desktop with scrolling columns, tree tiling, floating
|
|
windows, and a shared theme for its desktop tools.
|
|
|
|
## 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](theme-engine.md).
|
|
3. Use the [configuration reference](configuration.md) 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](shortcuts.md), including Super-drag to move
|
|
and Super-right-drag to resize floating windows.
|
|
|
|
## Desktop guides
|
|
|
|
- [Desktop widgets](desktop-widgets.md): clocks and sticky notes.
|
|
- [Notifications](notifications.md): history and Do Not Disturb.
|
|
- [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.
|
|
|
|
Use Settings or edit `~/.config/ferese/config.kdl`. Changes reload automatically;
|
|
invalid edits keep the last working configuration.
|
|
|
|
## Troubleshooting
|
|
|
|
See [logs and recovery](installation.md#logout-and-recovery). `feresectl exit`
|
|
ends the session immediately; `feresectl request-logout` asks for confirmation.
|
|
|
|
Report problems in the [issue tracker](https://github.com/ferese-wm/ferese/issues).
|
|
Include reproduction steps, whether Ferese ran as a nested preview or a direct
|
|
session, and relevant logs. Contributors can start with [Development](development.md).
|