lesavka/docs/operational-env.md

Lesavka operational environment variables

This is the tracked inventory for LESAVKA_* knobs used by source, scripts, CI, and tests. The hygiene gate fails when a new variable is added without appearing here, which keeps operator-facing configuration from drifting into folklore.

Hardware-facing assumptions belong near the code that uses them; this file is the repo-wide index.

Install security flow: the server installer creates /etc/lesavka/lesavka-client-pki.tar.gz and makes it readable only by the installing account. The client installer first uses LESAVKA_CLIENT_PKI_BUNDLE when supplied, otherwise it tries to fetch that same bundle from LESAVKA_CLIENT_PKI_SSH_SOURCE over SSH. Runtime clients require the installed ca.crt, client.crt, and client.key for HTTPS/mTLS relay connections.

| LESAVKA_ALLOW_GADGET_CYCLE | document near use before promoting to operator config | | LESAVKA_ALLOW_GADGET_RESET | permits installer/recovery flows to reset the USB gadget when a hard rebuild is otherwise required; by itself it must not force a live attached-host reset | | LESAVKA_ALLOW_INSECURE | client transport override; permits non-local http:// relay URLs only for lab/debug use | | LESAVKA_ALSA_DEV | server hardware/device override | | LESAVKA_ATTACH_WRITE_UDC | server hardware/device override | | LESAVKA_AUDIO_AUTO_RECOVER_AFTER | client media capture/playback override | | LESAVKA_AUDIO_AUTO_RECOVER_COOLDOWN_MS | client media capture/playback override | | LESAVKA_AUDIO_AUTO_RECOVER_USB | client media capture/playback override | | LESAVKA_AUDIO_DISABLE | client media capture/playback override | | LESAVKA_AUDIO_GAIN | client media capture/playback override | | LESAVKA_AUDIO_GAIN_CONTROL | client media capture/playback override | | LESAVKA_AUDIO_FAIL_ON_IDLE | server remote-speaker capture debug guardrail; default keeps idle UAC streams open | | LESAVKA_AUDIO_INIT_ATTEMPTS | client media capture/playback override | | LESAVKA_AUDIO_INIT_DELAY_MS | client media capture/playback override | | LESAVKA_AUDIO_MIN_PACKETS_PER_SEC | server remote-speaker capture debug guardrail; unset disables packet-rate hard failures | | LESAVKA_AUDIO_SINK | client media capture/playback override | | LESAVKA_AUDIO_SOURCE_GRACE_MS | server remote-speaker capture startup grace before optional watchdog checks | | LESAVKA_AUDIO_SOURCE_IDLE_MS | server remote-speaker capture idle window used only when idle hard-fail is enabled | | LESAVKA_BOOL_TEST | test/build contract variable; not runtime operator config | | LESAVKA_BREAKOUT_PREVIEW_HEIGHT | eye preview/video transport override | | LESAVKA_BREAKOUT_PREVIEW_MAX_KBIT | eye preview/video transport override | | LESAVKA_BREAKOUT_PREVIEW_WIDTH | eye preview/video transport override | | LESAVKA_BREAKOUT_REQUEST_FPS | eye preview/video transport override | | LESAVKA_BREAKOUT_REQUEST_HEIGHT | eye preview/video transport override | | LESAVKA_BREAKOUT_REQUEST_WIDTH | eye preview/video transport override | | LESAVKA_CAM_ALLOW_PROFILE_OVERRIDE | lab-only override that lets launcher camera width/height/fps env values beat the server-negotiated UVC profile | | LESAVKA_CAM_BY_ID_DIR | client media capture/playback override | | LESAVKA_CAM_CODEC | client media capture/playback override | | LESAVKA_CAM_DEV_ROOT | client media capture/playback override | | LESAVKA_CAM_DISABLE | client media capture/playback override | | LESAVKA_CAM_FORMAT | client media capture/playback override | | LESAVKA_CAM_FPS | client media capture/playback override | | LESAVKA_CAM_H264_KBIT | client media capture/playback override | | LESAVKA_CAM_HEIGHT | client media capture/playback override | | LESAVKA_CAM_JPEG_QUALITY | client media capture/playback override | | LESAVKA_CAM_KEYFRAME_INTERVAL | client media capture/playback override | | LESAVKA_CAM_MJPG | client media capture/playback override | | LESAVKA_CAM_OUTPUT | client media capture/playback override | | LESAVKA_CAM_SOURCE | client media capture/playback override | | LESAVKA_CAM_TEST_ENCODER | client media capture/playback override | | LESAVKA_CAM_TEST_PATTERN | client media capture/playback override | | LESAVKA_CAM_WIDTH | client media capture/playback override | | LESAVKA_CALIBRATION_PATH | server upstream A/V calibration storage path override | | LESAVKA_CAPTURE_POWER_GRACE_SECS | runtime/install/session override | | LESAVKA_CAPTURE_POWER_UNIT | runtime/install/session override | | LESAVKA_CAPTURE_REMOTE | runtime/install/session override | | LESAVKA_CLOCK_ALIGNMENT_SAMPLES | manual direct UVC/UAC probe freshness trust gate; number of server-to-capture persistent SSH midpoint clock samples, using the lowest-uncertainty sample, defaults to 5 | | LESAVKA_CLIENT_APP_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_BUNDLE | server installer output path for the generated client TLS enrollment bundle | | LESAVKA_CLIENT_CAPTURE_DIR | client installer capture folder override; defaults to ~/Pictures/lesavka | | LESAVKA_CLIENT_CAMERA_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_INPUTS_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_KEYBOARD_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_MAIN_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_MICROPHONE_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_MOUSE_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_OUTPUT_AUDIO_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_OUTPUT_DISPLAY_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_OUTPUT_VIDEO_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_PKI_BUNDLE | client installer input path for a server-generated TLS enrollment bundle | | LESAVKA_CLIENT_PKI_AUTO_FETCH | client installer toggle for SSH enrollment auto-fetch; defaults to enabled | | LESAVKA_CLIENT_PKI_DIR | client installer/runtime TLS identity directory override | | LESAVKA_CLIENT_PKI_SSH_SOURCE | client installer SSH source for auto-fetching the server enrollment bundle; defaults to theia:/etc/lesavka/lesavka-client-pki.tar.gz | | LESAVKA_CLIENT_RELAYCTL_BIN_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIENT_VIDEO_SUPPORT_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CLIPBOARD_CHORD | input routing/clipboard override | | LESAVKA_CLIPBOARD_CMD | input routing/clipboard override | | LESAVKA_CLIPBOARD_DEBOUNCE_MS | input routing/clipboard override | | LESAVKA_CLIPBOARD_DELAY_MS | input routing/clipboard override | | LESAVKA_CLIPBOARD_MAX | input routing/clipboard override | | LESAVKA_CLIPBOARD_PASTE | input routing/clipboard override | | LESAVKA_CLIPBOARD_TIMEOUT_MS | input routing/clipboard override | | LESAVKA_COMMON_CLI_BIN_SRC | test/build contract variable; not runtime operator config | | LESAVKA_CORE_HELPER | runtime/install/session override | | LESAVKA_DECODER_PROBE_BUFFERS | manual probe override | | LESAVKA_DECODER_PROBE_POLL_SECONDS | manual probe override | | LESAVKA_DECODER_PROBE_WAIT_SECONDS | manual probe override | | LESAVKA_DETACH_CLEAR_UDC | server hardware/device override | | LESAVKA_DEV_MODE | document near use before promoting to operator config | | LESAVKA_DISABLE_UAC | document near use before promoting to operator config | | LESAVKA_DISABLE_UVC | document near use before promoting to operator config | | LESAVKA_DISABLE_VIDEO_RENDER | eye preview/video transport override | | LESAVKA_DUMP_VIDEO | eye preview/video transport override | | LESAVKA_EYE_ADAPTIVE | eye preview/video transport override | | LESAVKA_EYE_APPSINK_BUFFERS | eye preview/video transport override | | LESAVKA_EYE_CAP_POLL_SECONDS | eye preview/video transport override | | LESAVKA_EYE_CAP_WAIT_SECONDS | eye preview/video transport override | | LESAVKA_EYE_CHAN_CAPACITY | eye preview/video transport override | | LESAVKA_EYE_DEVICE_POLL_MS | eye preview/video transport override | | LESAVKA_EYE_DEVICE_WAIT_MS | eye preview/video transport override | | LESAVKA_EYE_FPS | eye preview/video transport override | | LESAVKA_EYE_KEYFRAME_INTERVAL | eye preview/video transport override | | LESAVKA_EYE_MIN_FPS | eye preview/video transport override | | LESAVKA_EYE_QUEUE_BUFFERS | eye preview/video transport override | | LESAVKA_EYE_TESTSRC_KBIT | eye preview/video transport override | | LESAVKA_FAKE_SYSTEMCTL_MODE | test/build contract variable; not runtime operator config | | LESAVKA_FOCUS_LAUNCHER_ON_LOCAL | launcher UI/runtime override | | LESAVKA_FORCE_CORE_REBUILD_WITHOUT_UDC | document near use before promoting to operator config | | LESAVKA_FORCE_GADGET_REBUILD | explicit maintenance-window override for hard UDC detach/rebind during server install; pair with LESAVKA_ALLOW_GADGET_RESET=1 only when a live gadget rebuild is intentional | | LESAVKA_GADGET_CONFIGFS_ROOT | server hardware/device override | | LESAVKA_GADGET_FORCE_CYCLE | server hardware/device override | | LESAVKA_GADGET_SYSFS_ROOT | server hardware/device override | | LESAVKA_GIT_SHA | runtime/install/session override | | LESAVKA_H264_DECODER | eye preview/video transport override | | LESAVKA_HDMI_CONNECTOR | server hardware/device override | | LESAVKA_HDMI_DRIVER | server hardware/device override | | LESAVKA_HDMI_FBDEV | server hardware/device override | | LESAVKA_HDMI_PRESENTATION_DELAY_US | server HDMI video latency override | | LESAVKA_HDMI_HEIGHT | server hardware/device override | | LESAVKA_HDMI_MODES | server hardware/device override | | LESAVKA_HDMI_RESTORE_CRTC | server hardware/device override | | LESAVKA_HDMI_SINK | server hardware/device override | | LESAVKA_HDMI_SKIP_VSYNC | server hardware/device override | | LESAVKA_HDMI_WIDTH | server hardware/device override | | LESAVKA_HEADLESS | runtime/install/session override | | LESAVKA_HELPER_ENV_DUMP | document near use before promoting to operator config | | LESAVKA_HID_DIR | server hardware/device override | | LESAVKA_HID_WRITE_RETRIES | server hardware/device override | | LESAVKA_HID_WRITE_RETRY_DELAY_MS | server hardware/device override | | LESAVKA_HW_H264 | document near use before promoting to operator config | | LESAVKA_ICON_NAME | launcher UI/runtime override | | LESAVKA_ICON_SEARCH_PATH | launcher UI/runtime override | | LESAVKA_INPUT_RELEASE_TIMEOUT_MS | input routing/clipboard override | | LESAVKA_INPUT_REMOTE_FAILSAFE_MS | input routing/clipboard override | | LESAVKA_INPUT_REMOTE_FAILSAFE_SECS | input routing/clipboard override | | LESAVKA_INPUT_RESCAN_MS | input routing/clipboard override | | LESAVKA_INPUT_TOGGLE_DEBOUNCE_MS | input routing/clipboard override | | LESAVKA_INPUT_TOGGLE_KEY | input routing/clipboard override | | LESAVKA_KERNEL_BRANCH | kernel build/install override | | LESAVKA_KERNEL_BUILD_ROOT | kernel build/install override | | LESAVKA_KERNEL_BUILD_USER | kernel build/install override | | LESAVKA_KERNEL_COMMIT | kernel build/install override | | LESAVKA_KERNEL_JOBS | kernel build/install override | | LESAVKA_KERNEL_PATCH_DIR | kernel build/install override | | LESAVKA_KERNEL_PATCH_DWC2_FIFO | kernel build/install override | | LESAVKA_KERNEL_PATCH_UVC_BULK | kernel build/install override | | LESAVKA_KERNEL_PATCH_UVC_DEBUG | kernel build/install override | | LESAVKA_KERNEL_PKGREL | kernel build/install override | | LESAVKA_KERNEL_PKG_REPO | kernel build/install override | | LESAVKA_KERNEL_REPO | kernel build/install override | | LESAVKA_KERNEL_UPDATE | kernel build/install override | | LESAVKA_KEYBOARD_DEVICE | input routing/clipboard override | | LESAVKA_LAUNCHER_CAMERA_DIR | launcher UI/runtime override | | LESAVKA_LAUNCHER_CHILD | launcher UI/runtime override | | LESAVKA_LAUNCHER_CLIPBOARD_CONTROL | launcher UI/runtime override | | LESAVKA_LAUNCHER_FOCUS_SIGNAL | launcher UI/runtime override | | LESAVKA_LAUNCHER_INPUT_CONTROL | launcher UI/runtime override | | LESAVKA_LAUNCHER_INPUT_STATE | launcher UI/runtime override | | LESAVKA_LAUNCHER_PARENT_PID | launcher UI/runtime override | | LESAVKA_LAUNCHER_PARENT_START_TICKS | launcher UI/runtime override | | LESAVKA_LAUNCHER_TOGGLE_KEY_CONTROL | launcher UI/runtime override | | LESAVKA_LAUNCHER_WINDOW_TITLE | launcher UI/runtime override | | LESAVKA_LIVE_KEYBOARD_REPORT_DELAY_MS | input routing/clipboard override | | LESAVKA_LIVE_MODIFIER_DELAY_MS | input routing/clipboard override | | LESAVKA_MAX_SPEED | document near use before promoting to operator config | | LESAVKA_MEDIA_CONTROL | launcher-to-relay live media control file; used for soft-pausing camera, mic, or speaker streams without hard-resetting USB | | LESAVKA_MEDIA_GATE_PUSHGATEWAY_JOB | CI metrics destination override | | LESAVKA_MIC_DISABLE | client media capture/playback override | | LESAVKA_MIC_DISABLE_PIPEWIRE | client media capture/playback override | | LESAVKA_MIC_GAIN | client media capture/playback override | | LESAVKA_MIC_GAIN_CONTROL | client media capture/playback override | | LESAVKA_MIC_INIT_ATTEMPTS | client media capture/playback override | | LESAVKA_MIC_INIT_DELAY_MS | client media capture/playback override | | LESAVKA_MIC_SOURCE | client media capture/playback override | | LESAVKA_MIC_TEST_SOURCE_DESC | client media capture/playback override | | LESAVKA_MOUSE_DEVICE | input routing/clipboard override | | LESAVKA_OUTPUT_DELAY_APPLY | manual direct UVC/UAC probe override; apply the measured server output-delay correction through the calibration API when the probe gates pass | | LESAVKA_OUTPUT_DELAY_APPLY_MODE | manual direct UVC/UAC probe override; absolute sets the active output-path baseline to the measured device delay, while relative preserves legacy nudge behavior | | LESAVKA_OUTPUT_DELAY_CALIBRATION | manual direct UVC/UAC probe override; emit output-delay-calibration.json from a lab-attached USB host capture of server-generated signatures, defaults to enabled | | LESAVKA_OUTPUT_DELAY_CONFIRM | manual direct UVC/UAC probe safety gate; after applying a ready output-delay measurement, rerun a fixed-delay confirmation probe that must pass sync, defaults to enabled | | LESAVKA_OUTPUT_DELAY_GAIN | manual direct UVC/UAC probe override; scales measured output-delay correction before applying, defaults to 1.0 | | LESAVKA_OUTPUT_DELAY_MAX_ABS_SKEW_MS | manual direct UVC/UAC probe safety limit; refuses to apply/save implausibly large measured device skew, defaults to 5000 | | LESAVKA_OUTPUT_DELAY_MAX_DRIFT_MS | manual direct UVC/UAC probe stability limit; refuses to apply/save unstable output-delay measurements, defaults to 80 | | LESAVKA_OUTPUT_DELAY_MAX_STEP_US | manual direct UVC/UAC probe safety limit; clamps one measured correction step, defaults to 1500000 | | LESAVKA_OUTPUT_DELAY_MIN_PAIRS | manual direct UVC/UAC probe evidence floor before applying measured output-delay calibration, defaults to 8 | | LESAVKA_OUTPUT_REQUIRE_SYNC_PASS | manual direct UVC/UAC probe safety gate; fail the run unless the analyzer verdict passes sync, used by fixed-delay confirmation | | LESAVKA_OUTPUT_DELAY_SAVE | manual direct UVC/UAC probe override; after applying a ready measured correction, persist it as the server default calibration | | LESAVKA_OUTPUT_DELAY_TARGET | manual direct UVC/UAC probe override; choose whether measured skew is corrected by shifting video or audio, defaults to video | | LESAVKA_OUTPUT_FRESHNESS_MAX_AGE_MS | manual direct UVC/UAC probe freshness gate; maximum clock-corrected server-feed-to-Tethys-observed p95 age, defaults to 1000 | | LESAVKA_OUTPUT_FRESHNESS_MAX_CLOCK_UNCERTAINTY_MS | manual direct UVC/UAC probe freshness trust gate; do not pass freshness when host clock alignment uncertainty exceeds this, defaults to 250 | | LESAVKA_OUTPUT_FRESHNESS_MAX_DRIFT_MS | manual direct UVC/UAC probe freshness gate; maximum allowed freshness drift across paired probe events, defaults to 100 | | LESAVKA_PASTE_DELAY_MS | input routing/clipboard override | | LESAVKA_PASTE_KEY | input routing/clipboard override | | LESAVKA_PASTE_KEY_FILE | input routing/clipboard override | | LESAVKA_PASTE_MAX | input routing/clipboard override | | LESAVKA_PASTE_RPC | input routing/clipboard override | | LESAVKA_PERFORMANCE_GATE_PUSHGATEWAY_JOB | CI metrics destination override for latency/performance checks | | LESAVKA_PREVIEW_HEIGHT | eye preview/video transport override | | LESAVKA_PREVIEW_MAX_KBIT | eye preview/video transport override | | LESAVKA_PREVIEW_REQUEST_FPS | eye preview/video transport override | | LESAVKA_PREVIEW_REQUEST_HEIGHT | eye preview/video transport override | | LESAVKA_PREVIEW_REQUEST_WIDTH | eye preview/video transport override | | LESAVKA_PREVIEW_WIDTH | eye preview/video transport override | | LESAVKA_REF | runtime/install/session override | | LESAVKA_RELOAD_UVCVIDEO | document near use before promoting to operator config | | LESAVKA_REPO_URL | runtime/install/session override | | LESAVKA_REQUIRE_TLS | server security override; require TLS credentials before binding public relay service | | LESAVKA_RGBA | document near use before promoting to operator config | | LESAVKA_SERVER_ADDR | runtime/install/session override | | LESAVKA_SERVER_BIND_ADDR | server bind address override; defaults to 0.0.0.0:50051 | | LESAVKA_INSTALL_SERVER_BIND_ADDR | installer override; sets the persisted default server bind address in /etc/lesavka/server.env | | LESAVKA_SERVER_GADGET_SRC | test/build contract variable; not runtime operator config | | LESAVKA_SERVER_HOST | manual probe override | | LESAVKA_SERVER_MAIN_SRC | test/build contract variable; not runtime operator config | | LESAVKA_SERVER_UVC_BIN_SRC | test/build contract variable; not runtime operator config | | LESAVKA_SERVER_VIDEO_SINKS_SRC | test/build contract variable; not runtime operator config | | LESAVKA_SERVER_VIDEO_SRC | test/build contract variable; not runtime operator config | | LESAVKA_SONAR_ENFORCE | CI gate enforcement override | | LESAVKA_SUPPLY_CHAIN_ENFORCE_TOOLS | CI gate enforcement override | | LESAVKA_TAP_AUDIO | client media capture/playback override | | LESAVKA_TLS_CA | client transport CA path override for relay TLS verification | | LESAVKA_TLS_CA_DAYS | server installer certificate-authority lifetime override | | LESAVKA_TLS_CERT | server TLS certificate path override | | LESAVKA_TLS_CERT_DAYS | server installer leaf certificate lifetime override | | LESAVKA_TLS_CLIENT_AUTH_OPTIONAL | server TLS override; allow clients without certs only for controlled migration/debug | | LESAVKA_TLS_CLIENT_CA | server TLS client-CA path override for mTLS verification | | LESAVKA_TLS_CLIENT_CERT | client transport certificate path override for mTLS | | LESAVKA_TLS_CLIENT_KEY | client transport private-key path override for mTLS | | LESAVKA_TLS_DIR | server installer/runtime TLS directory override | | LESAVKA_TLS_DOMAIN | client transport SNI/domain override when dialing by IP | | LESAVKA_TLS_KEY | server TLS private-key path override | | LESAVKA_TLS_SAN | server installer extra certificate SAN list for additional relay hostnames/IPs | | LESAVKA_UAC_BUFFER_TIME_US | server audio sink latency override | | LESAVKA_UAC_COMPENSATION_US | server audio sink latency override | | LESAVKA_UAC_DEV | server hardware/device override | | LESAVKA_UAC_HDMI_COMPENSATION_US | server HDMI audio sink latency override; defaults to 205000 to hold gadget audio back toward the host-observed HDMI video path | | LESAVKA_UAC_LATENCY_TIME_US | server audio sink latency override | | LESAVKA_UAC_SESSION_CLOCK_ALIGN | server audio sink clock-alignment override; defaults to 0 | | LESAVKA_TEST_CAM_U32 | test/build contract variable; not runtime operator config | | LESAVKA_TEST_CAP_CAMERA | test/build contract variable; not runtime operator config | | LESAVKA_TEST_CAP_MIC | test/build contract variable; not runtime operator config | | LESAVKA_TEST_ASOUND_CARDS | test/build contract variable; not runtime operator config | | LESAVKA_TEST_ASOUND_PCM | test/build contract variable; not runtime operator config | | LESAVKA_TEST_DISABLE_H264_DECODERS | test/build contract variable; not runtime operator config | | LESAVKA_TEST_FORCE_PIPELINE_START_ERROR | test/build contract variable; not runtime operator config | | LESAVKA_TEST_GATE_PUSHGATEWAY_JOB | test/build contract variable; not runtime operator config | | LESAVKA_TEST_RECOVERY_STATE | test/build contract variable; not runtime operator config | | LESAVKA_TEST_RECOVERY_STATE_ERROR | test/build contract variable; not runtime operator config | | LESAVKA_TEST_SKIP_APP | test/build contract variable; not runtime operator config | | LESAVKA_TEST_SWAY_GET_OUTPUTS_EXIT | test/build contract variable; not runtime operator config | | LESAVKA_TEST_SWAY_LOG | test/build contract variable; not runtime operator config | | LESAVKA_TEST_SWAY_OUTPUTS | test/build contract variable; not runtime operator config | | LESAVKA_TEST_SWAY_PLACE_EXIT | test/build contract variable; not runtime operator config | | LESAVKA_TEST_U32 | test/build contract variable; not runtime operator config | | LESAVKA_TEST_U32_OPT | test/build contract variable; not runtime operator config | | LESAVKA_TEST_U8 | test/build contract variable; not runtime operator config | | LESAVKA_TEST_UDEV_CAPTURE_DEVICES | test/build contract variable; not runtime operator config | | LESAVKA_TEST_USIZE | test/build contract variable; not runtime operator config | | LESAVKA_TEST_UVC_HELPER_RESTART_ERR | test/build contract variable; not runtime operator config | | LESAVKA_TEST_VIDEO_SOURCE | test/build contract variable; not runtime operator config | | LESAVKA_TOUCHPAD_SCALE | input routing/clipboard override | | LESAVKA_UAC_DEV | server hardware/device override | | LESAVKA_UAC_SESSION_CLOCK_ALIGN | server audio sink clock-alignment override; 0 is the host-validated default | | LESAVKA_UPSTREAM_AUDIO_PLAYOUT_MODE_OFFSETS_US | server upstream per-UVC-mode UAC output-path map, e.g. 1280x720@20=0,1280x720@30=0,1920x1080@20=0,1920x1080@30=0 | | LESAVKA_UPSTREAM_AUDIO_PLAYOUT_OFFSET_US | server upstream output-path override; v2 uses it as the explicit UAC handoff delay relative to the shared client capture clock | | LESAVKA_UPSTREAM_AUDIO_MASTER_WAIT_GRACE_MS | server upstream sync override; how long video may wait past its nominal due time for UAC audio to reach the matching timestamp, defaults to 350 | | LESAVKA_UPSTREAM_BUNDLED_PLAYOUT_DELAY_MS | compatibility alias for LESAVKA_UPSTREAM_V2_PLAYOUT_DELAY_MS | | LESAVKA_UPSTREAM_MAX_LIVE_LAG_MS | compatibility alias for LESAVKA_UPSTREAM_V2_MAX_LIVE_AGE_MS | | LESAVKA_UPSTREAM_PAIR_SLACK_US | server upstream pairing override; how far video may diverge from the planned audio-master capture moment before the frame is held or dropped, defaults to 80000 | | LESAVKA_UPSTREAM_PLAYOUT_DELAY_MS | server upstream pairing/synchronization target buffer; the server uses this shared buffer to pair webcam frames with matching gadget-mic audio before remote presentation, defaults to 350 | | LESAVKA_UPSTREAM_STARTUP_TIMEOUT_MS | server upstream startup guard; paired startup must converge before this timeout or fail visibly, defaults to 60000 | | LESAVKA_UPSTREAM_STALE_DROP_MS | server upstream freshness override; late audio/video that miss this budget are dropped instead of silently extending lag, defaults to 80 | | LESAVKA_UPSTREAM_TIMING_TRACE | upstream capture/rebase trace override for sync debugging | | LESAVKA_UPSTREAM_V2_MAX_LIVE_AGE_MS | v2 bundled webcam freshness ceiling; bundles already older than this are dropped as one unit, defaults to 1000 | | LESAVKA_UPSTREAM_V2_PLAYOUT_DELAY_MS | v2 optional common playout slack after sync offsets; defaults to 20 and is reduced when needed to protect the live-age budget | | LESAVKA_UPSTREAM_VIDEO_PLAYOUT_MODE_OFFSETS_US | server upstream per-UVC-mode output-path map; shipped MJPEG defaults are 1280x720@20=162659,1280x720@30=135090,1920x1080@20=160045,1920x1080@30=127952 | | LESAVKA_UPSTREAM_VIDEO_PLAYOUT_OFFSET_US | server upstream output-path override; v2 uses it as the explicit UVC handoff delay relative to the shared client capture clock, defaults to the calibrated MJPEG/UVC offset | | LESAVKA_UPLINK_CAMERA_PREVIEW | client media capture/playback override | | LESAVKA_UPLINK_MIC_LEVEL | client media capture/playback override | | LESAVKA_INSTALL_UVC_CODEC | installer override; sets the persisted default UVC webcam codec in /etc/lesavka/server.env and /etc/lesavka/uvc.env | | LESAVKA_USB_RECOVERY_ | USB recovery timing override | | LESAVKA_USB_RECOVERY_CYCLE_WAIT_MS | USB recovery timing override | | LESAVKA_USB_RECOVERY_FINAL_WAIT_MS | USB recovery timing override | | LESAVKA_USB_RECOVERY_REBUILD_WAIT_MS | USB recovery timing override | | LESAVKA_UVC_APP_BLOCK | server hardware/device override | | LESAVKA_UVC_BLOCKING | server hardware/device override | | LESAVKA_UVC_BULK | server hardware/device override | | LESAVKA_UVC_BUFFER_COUNT | UVC helper freshness override; number of queued gadget output buffers, defaults to 2 for live-call freshness | | LESAVKA_UVC_BY_PATH_ROOT | server hardware/device override | | LESAVKA_UVC_CODEC | server hardware/device override | | LESAVKA_UVC_CTRL_BIN | server hardware/device override | | LESAVKA_UVC_CTRL_INTF | server hardware/device override | | LESAVKA_UVC_CTRL_LEN | server hardware/device override | | LESAVKA_UVC_DEBUG | server hardware/device override | | LESAVKA_UVC_DEV | server hardware/device override | | LESAVKA_UVC_DISABLE_IRQ | server hardware/device override | | LESAVKA_UVC_EXTERNAL | server hardware/device override | | LESAVKA_UVC_FALLBACK | server hardware/device override | | LESAVKA_UVC_FPS | server hardware/device override | | LESAVKA_UVC_FRAME_MAX_AGE_MS | UVC helper freshness override; stale spooled MJPEG frames older than this are not replayed, defaults to 1000; 0 disables TTL | | LESAVKA_UVC_FRAME_SIZE | server hardware/device override | | LESAVKA_UVC_HEIGHT | server hardware/device override | | LESAVKA_UVC_IDLE_PUMP_MS | UVC helper freshness override; idle poll sleep while pumping host-returned buffers, defaults to 2 | | LESAVKA_UVC_INTERVAL | server hardware/device override | | LESAVKA_UVC_LIMIT_PCT | server hardware/device override | | LESAVKA_UVC_MAXBURST | server hardware/device override | | LESAVKA_UVC_MAXPACKET | server hardware/device override | | LESAVKA_UVC_MAXPAYLOAD_LIMIT | server hardware/device override | | LESAVKA_UVC_MJPEG | server hardware/device override | | LESAVKA_UVC_SKIP_UDEV | server hardware/device override | | LESAVKA_UVC_STREAMING_INTERVAL | server hardware/device override | | LESAVKA_UVC_STREAM_INTF | server hardware/device override | | LESAVKA_UVC_WIDTH | server hardware/device override | | LESAVKA_VIDEO_MAX_KBIT | eye preview/video transport override | | LESAVKA_VIDEO_QUEUE | eye preview/video transport override | | LESAVKA_VIEW_MODE | launcher UI/runtime override | | LESAVKA_ALLOW_EXTERNAL_UVC_GADGET_CYCLE | server hardware/device override | | LESAVKA_CAPTURE_READY__ | manual probe marker; not runtime operator config | | LESAVKA_FORCE_SOFT_CONNECT | server hardware/device override | | LESAVKA_HDMI_QUEUE_BUFFERS | server HDMI video latency override | | LESAVKA_INSTALL_CAM_OUTPUT | install-time server camera output selection | | LESAVKA_KERNEL_SKIP_CPUINFO_PATCH | kernel build/install override | | LESAVKA_LAUNCHER_MEASURE_EXIT | launcher UI/runtime override | | LESAVKA_LAUNCHER_MEASURE_PATH | launcher UI/runtime override | | LESAVKA_SERVER_CONNECT_HOST | manual probe override | | LESAVKA_SERVER_ENV | server/install environment file override | | LESAVKA_SERVER_LOG_PATH | server logging path override | | LESAVKA_SYNC_PROBE_AUDIO_DUMP | manual probe override | | LESAVKA_UAC_SANITY_DEV | manual UAC sanity probe override | | LESAVKA_UAC_SANITY_FREQ | manual UAC sanity probe override | | LESAVKA_UAC_SANITY_SECONDS | manual UAC sanity probe override | | LESAVKA_UAC_SANITY_VOLUME | manual UAC sanity probe override | | LESAVKA_UPLINK_TELEMETRY | launcher/uplink telemetry path override | | LESAVKA_UPSTREAM_CAMERA_STARTUP_GRACE_MS | upstream A/V timing override | | LESAVKA_UPSTREAM_CAMERA_STARTUP_GRACE_US | upstream A/V timing override used by test contracts and server startup grace handling | | LESAVKA_UPSTREAM_REANCHOR_LATE_MS | upstream A/V timing override | | LESAVKA_UPSTREAM_SOURCE_LAG_CAP_MS | client upstream source freshness cap before camera/mic buffers are treated as stale; defaults to 250 | | LESAVKA_UVC_CONTROL_READ_ONLY | UVC helper runtime override | | LESAVKA_UVC_FRAME_PATH | UVC helper MJPEG frame spool path | | LESAVKA_UVC_LOCK_PATH | UVC helper singleton lock path | | LESAVKA_UVC_MJPEG_IO_MODE | UVC helper MJPEG streaming mode override | | LESAVKA_UVC_MJPEG_SPOOL | UVC helper MJPEG spool toggle | | LESAVKA_UVC_SESSION_CLOCK_ALIGN | UVC helper timing override |