Files
feresaria/docs/configuration/session-protocols.md
T

34 lines
2.1 KiB
Markdown

# Optional session protocols
These are launch-time environment switches, not KDL keys. Enable only for
trusted clients: `FERESE_ENABLE_INPUT_METHOD=1`,
`FERESE_ENABLE_SHORTCUT_INHIBIT=1`, `FERESE_ENABLE_SCREENCOPY=1`.
The installed session launcher enables screencopy for screenshots unless
`FERESE_ENABLE_SCREENCOPY=0` is explicitly set in its environment. Setting it
to `0` disables every path that can read the screen, including the built-in
screenshot command, not just the Wayland protocol. A session launched by hand
rather than through `ferese-session` needs `FERESE_ENABLE_SCREENCOPY=1` in its
environment for screenshots to work.
Text input is available by default; Ctrl+Alt+Escape releases an active shortcut
inhibitor. Use `feresectl --help` for runtime control commands.
On the local Rime prototype branch, `FERESE_ENABLE_INPUT_METHOD=1` also enables
`zwp_virtual_keyboard_manager_v1`, which native input-method-v2 clients use to
forward unconsumed keys. Both globals remain hidden by default. Treat the flag
as permission for trusted session clients; virtual key events are rejected
while the session lock is active. See [the isolated Rime prototype](../development/rime-poc.md).
`FERESE_ENABLE_TEST_POINTER=1` exposes `zwlr_virtual_pointer_manager_v1` for
isolated UI regression checks. It is off by default and rejects events while
locked. The test launcher uses a private runtime; this switch is not needed by
the Rime service or normal keyboard candidate selection.
Shell rounding is controlled in Settings → Panel & Shell → Shell corner radius.
The shell and compositor use the same squircle profile for fills, borders, shadows
and blur masks. Small controls cap the radius to fit their size; circles and pills
keep circular outlines. The measured profile has small tangent and curvature
discontinuities at its internal segment joins. Window rounding remains under
Settings → Windows. Shell rounding comes from `theme.geometry.shell-radius`,
which defaults to 14 px. Panel corners follow their selected style and height,
with optional overrides in the [panel configuration](../panel-configuration.md#background-outline-and-corners).