2.3 KiB
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.
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.