35 lines
2.3 KiB
Markdown
35 lines
2.3 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.
|
|
Settings checks the actual Wayland registry before offering shortcut recording. With shortcut inhibition disabled, use its modifier buttons and searchable key menu. Enabling the launch-time flag requires starting a new Ferese session.
|
|
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).
|