mirror of
https://github.com/DeeJanuz/frametop.git
synced 2026-10-06 01:00:06 +02:00
* Input relay: typing with the pointer helper down no longer ends the relay Typing on a pass-through keyboard tells the helper "typing". With the helper not running (SteamVR off), that send raised ConnectionRefusedError and the relay exited, dropping every grab until systemd restarted it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * ft-steam: open Steam's menu through Steam's own UI steam/ft-steam menu opens the SteamVR dashboard on Steam's menu, or closes the dashboard if it's up, without pointer mode: it asks Steam's UI over its debugging port to show its dashboard overlay (ShowVROverlay, what Steam calls itself) and focus the Steam frame's left menu (MenuStore.OpenMainMenu). ft-steam check says whether those calls still exist, and update-check.py runs it, since a Steam client update can rename them. The CDP client moves from display-settings/steam_settings.py to steam/steamui.py, so both use it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Shortcuts: Steam menu, commands, and modifier taps Key combinations (and mouse and controller buttons) get two new actions: - steam_menu: Open Steam menu / close dashboard (steam/ft-steam menu). - command:CMD: run CMD with sh -c, as the relay's service, with layout/, float/ and steam/ on its PATH. Input Settings offers it for key combinations as Run a command... Both work without pointer mode. A modifier on its own is now a key combination too: a tap, pressed and released with no other key, mouse button, or scroll in between. A bound tap sends the desktop F24 before the release, so Plasma's launcher stays shut. The defaults gain a Meta tap for the Steam menu; this replaces META_DASHBOARD, which only worked in pointer mode. input/test/keys-test.py runs the relay against fake devices with every outgoing socket renamed, so it's safe next to the live relay. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Relay: share a key combination's Meta release with frame-voice A Meta+key combination (Meta+J for gaze_left, say) hides Meta's release from the desktop, and the relay skipped share_key for it too. frame-voice saw Meta go down on @frametop_keys and never come up, so it held all dictated text back, waiting for that release. Keys of grabbed keyboards are now shared as pressed, before key_binding() decides what the desktop gets. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: ft-cutouts, the hand cutouts without pinches and grips hands/ft-cutouts on|off|status starts ft-camd and ft-hands as transient user units with ft-hands' new --no-gestures: hands are published for ft-screens' cutouts, but no pinch or grip is detected, so nothing clicks or drags and a closing hand doesn't raise the tracking rate. It needs a build and ft-camd's capabilities, not hands/run.sh install. Its units conflict with ft-handsctl's, so each stops the other, and they stop with SteamVR. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * ft-cutouts status: only the current run's tracker lines Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: say why gaze mode can't work yet, and open the calibration whenever it's missing Turning gaze mode on without a calibration opened Calibrate only on the off-to-on change, and only if it could open right then. With the headset off, the eye tracker silent, or the panel not built, or with gaze mode already on when the gaze service started, nothing opened and nothing said why: the pointer just stayed a mouse. - The gaze service now checks every second: gaze mode on, no calibration for the tracker in use, eyes seen -> the full calibration opens. One that closes unfinished opens again only after the headset comes off and on, gaze mode off and on, or Calibrate, so it doesn't loop. A start that fails retries every 10 s. - Its status says why gaze mode can't work yet (checks.problem): not calibrated and opening, open, closed unfinished, or can't open and why. - Input Settings shows that under the Gaze pointer switch, along with the gaze service not installed or not running and our tracker missing its frame grabber. - ft-gazectl on notes a missing calibration. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: install our eye tracker, prefer it, and say why a calibration dot wasn't taken A user on a fresh install got "Calibration failed: only 0 of 21 dots" with no reason. The installer never installed our tracker, so gaze used SteamVR's, and the only way SteamVR's tracker rejects a dot is losing an eye for most of the look. The panel just showed a red ring. - install.sh: step 9/10 installs our tracker (gaze/tracker/install.sh) after gaze mode, yes by default; it needs sudo, so --yes runs it only when sudo won't prompt. If it fails, gaze keeps SteamVR's tracker. Configs that still say GAZE_TRACKER=steam (the old template) are asked whether to switch. - GAZE_TRACKER=auto, the new default: ours when it's installed (the frame grabber, its unit, and ft-eyes' Python), else SteamVR's. ft-gazed rechecks every second, so installing it switches over. Input Settings lists Own tracker first as recommended, and says how to install it when it's missing (checking the host's /etc through /run/host from the dev container). - The calibration panel has a note line, orange over the instructions: why a dot wasn't taken (an eye lost, a blink, the eyes disagreeing for SteamVR's tracker, from steady_samples' new drop counts; ft-eyes' reply for ours), what a click is still waiting for after 1.5 s, and a failed calibration's most common reason, which the Gaze page shows too. steady_samples keeps the same samples as before (checked on 2037 windows of recordings); a lost eye is named before a blink, since its openness reads 0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * README: link the Frametop Discord Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Wait for a new container to finish setting up before entering it container-up.sh starts the dev container in a scope of its own, so distrobox enter finds it running and skips its wait for distrobox-init. On a fresh install, init was still setting up passwordless sudo when dev-container.sh ran sudo dnf install, and sudo asked for a password with no terminal to read it from. container-up.sh now waits for container_setup_done itself, and the container's sudo calls use -n, so a password prompt fails at once with a clear message. Fixes #9 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Prevent small desktop overlay pointer movements from starting a drag * Clear reported drag state on controller release * Click stability: only a hand controller's press starts it The 3D mouse drives SteamVR's laser through the ft_pointer virtual controller, so its events reach the screens the same way a controller's do. The filter held every press, which turned the mouse's short drags (selecting a character or two, nudging a slider) into clicks. Mark button events from hand controllers and start the filter only on those. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Input relay: retry a new device until udev gives it to the input group A new /dev/input node is root:root 0600 until udev applies GROUP=input. The scan probed each new node once and marked it seen even when the open failed, so a node caught in that gap was never opened. Behind a KVM, a switch brings back a hub of devices at once: on the Frame, four nodes failed with EACCES in one switch, the keyboard was never grabbed, and its keys went to gamescope instead of the desktop screens. A node that isn't readable yet now waits for the next scan. * Screens: take a screen's overlays from one copy in the catcher While a button pressed on a screen is held, UpdateCatcher checks every tick whether the laser is still on one of the screen's overlays. It built that list from s.All().begin() and s.All().end(), but All() returns a std::array by value: iterators into two different temporaries, which is undefined behaviour. A clang build of ft-screens got a garbage length, threw std::length_error, and aborted on the first click, taking KWin and the desktop with it. * Gaze: leave SteamVR's gaze action alone during VR games From curiousjtuber's PR #13: with the gaze service running, SteamVR restarted its eye tracker every 10 to 13 s of Beat Saber, as if the headset came off, and each restart took input focus from the game. The PR stopped every read in a game. Only the action path reaches SteamVR (UpdateActionState on the gaze set at overlay-global priority, then GetEyeTrackingDataRelativeToNow); the mmap and our tracker are read-only files. So only the action is skipped while a scene app runs, and gaze keeps moving the pointer over the dashboard in a game. The action source is only used with --source action. Co-Authored-By: CuriousJ <curious.j.tuber@gmail.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: --record-hz, and the hand recorder's design (hands/rec/DESIGN.md) ft-hands --record-hz N records at most N frame sets a second, for the hand recorder (10). DESIGN.md lays out the recorder: the headset panel, the session runner and its script, the files, review and export, consent. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: ft-handpanel, the hand recorder's headset panel A head-locked SteamVR overlay for the hand recorder (hands/rec/DESIGN.md): 1.2 m ahead, 12 degrees up, 36 degrees wide, drawn with stb_truetype into three shared DMA-BUFs as ft-gazepanel does. It shows the title, step, wrapped instruction, note, countdown, hand chips, near/far bar and a "Paused" cover, driven over @ft_handpanel. It also places the touch target, a 2 cm dot in its own overlay fixed in the room where the head was at the first command for that point, and logs head and controller poses to poses.jsonl at 250 Hz from a thread of its own. Both threads take one lock around OpenVR calls. --no-vr prints each picture's state to stdout (and --dump writes the pictures), for testing without a headset. hands/rec/build.sh builds it in the dev container. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the recorder's worn check goes by the panel's backlight, as frame-job does Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the hand recorder's session runner and guided script hands/rec/session.py runs a recording session from script.json: it starts ft-camd and a tracking ft-hands as transient units only if they aren't running, records each section as one take (ft-hands --record-only at 10 sets/s, a new sets-N.bin after each pause), drives ft-handpanel, and writes session.json, calibration.json (identifying fields removed), prompts.jsonl and take.json. Feedback comes from the live hands file and, in the controller sections, from the panel's device poll. It also runs from the command line (--dry-run, --speed, --ring, --no-start). hands/rec/script.json: 11 sections, about 9 minutes without the object and controller sections. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the hand recorder's window, review and export hands/rec/ft_handrec.py + main.qml (Kirigami, dev container; host launcher hands/rec/ft-handrec): consent (CONSENT.md, asked again when its version changes; profile.json with a random contributor id), the before-you-start checklist with the lighting and free-space checks, the session controls (Space pauses, Esc stops), review with a frame-set viewer that deletes ranges, takes and sessions, export with progress and cancel (warns while the headset is worn), and the upload page (UPLOAD.md, the huggingface-cli command; HF_DATASET is a placeholder). --dry-run runs sessions without processes, for testing. hands/rec/takes.py (standard library): indexes sets.bin and sets-N.bin without reading pixels, reads one set's cameras, keeps deleted ranges in take.json, and exports: deleted sets left out, zstd -10 -T2 at nice 19, manifest.json and SHA256SUMS, nothing left behind on cancel. CONSENT.md and UPLOAD.md are drafts pending a legal review; the window says contributions aren't open yet. The dev container gains zstd. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: upload from the hand recorder's window, export checks, a rehearsal hands/rec/validate.py (standard library; Linux and Windows, Python 3.12+) checks an export before upload and when it's received: SHA256SUMS, an allow-list of files, the manifest's schema and keys, the consent version, a uuid4 contributor, no identifying fields in calibration.json or device.json, every sets.bin.zst decompressed to its end as a stream with each FHSET01 header checked against the manifest, jsonl lines, the total size. It decompresses with compression.zstd, zstandard or the zstd program. validate.py DIR [--json]. hands/rec/hub.py uploads an export with huggingface_hub, as a pull request to contributions/<contributor>/<session>: validate first, refuse a repeat of the same export, check the login (whoami) and access (auth_check), upload_folder(create_pr=True) with the manifest summary as the description, then record the PR under "uploads" in session.json. Errors are explained (terms not accepted, not found, 401/403, network). --dry-run makes no network calls. FT_HANDREC_DATASET overrides HF_DATASET (DeeJanuz/frametop-hands); while the texts are drafts a real upload needs FT_HANDREC_ALLOW_UPLOAD=1. The Upload page shows the login with "Check again" and how to run hf auth login in a terminal (the token never enters the window), then Upload with a phase, progress and Cancel (hub.py as a child process), the PR link, and a warning for an export uploaded before. The manual command stays as the fallback. ft-handrec --hub-dry-run. session.py also saves device.json: cv.cad_from_cal and head from /persist/device_config.json, the labeller's shape, nothing identifying; export copies it. Session ids with a -N suffix are accepted everywhere. hands/rec/rehearse.sh runs it all without the headset: ft-ringplay plays 30 s of a capture into a ring, session.py records a short test script with ft-handpanel --no-vr and a tracker, then export, validate and a dry-run upload (--repo ID uploads for real). It runs in one frame-job scope, deletes its data and stops its processes, also on Ctrl+C. hands/rec/tests/test_validate.py covers good and broken exports and hub.py without the network. The dev container gains python3-huggingface-hub. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * README: Frametop doesn't work on the SteamOS beta yet Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit072a294941) * Hands: step mode and pose pictures for the hand recorder The first real session moved on every 5 s with text only, too fast to follow. Each step now waits for Next (Space or the window's button), counts down 3-2-1 while recording, then holds. P pauses, R redoes a step, S skips a section; "Advance by itself" (--auto) keeps the old timed flow. Nothing records while a step waits: each step is its own recording part. The panel and the window show a picture of each pose (hands/rec/poses, generated by make_poses.py from a parametric hand, MIT) and a diagram of where to hold the hands and how far out. prompts.jsonl gains ready, wait and redo events; session.json gains mode. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the headset button as Next, clearer push steps The headset's right-side click button (KEY_SELECT on gpio-keys, read without a grab) now works the session: Next while a step waits, pause during a hold, resume while paused. With no mouse connected the hints lead with it. The push sections say plainly to push straight out from the headset and pull back, with a side-view picture of the head, the headset and the arrow, and the bar's ends read "At your chest" and "Arm out". The bar labels are sent as one field, so labels with spaces no longer split. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * ft-floatd: a launch for a missing app no longer kills the control socket Gio.DesktopAppInfo.new() returns NULL for a desktop file that doesn't exist, and PyGObject raises TypeError ("constructor returned NULL") rather than returning None, so launch()'s `if info is None` never ran. The exception escaped the control socket's GLib callback, GLib dropped the watch, and ft-floatd stopped answering everything: the float key, dock, Launch as Standalone, and profiles, until the desktop restarted. Found on the Frame (2026-10-02): a profile saved with RustDesk's Flatpak open records its window's app id, com.carriez.flutter_hbb, which has no desktop file (the Flatpak's is com.rustdesk.RustDesk). `ft-layout use` on that profile asked ft-floatd to launch it, and ft-floatd went silent. With this, that launch replies "error no app com.carriez.flutter_hbb" and the profile's other apps open. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * ft-floatd: profiles keep and relaunch Flatpak apps whose window names another app id An X11 window in a Flatpak can give KWin an app id with no desktop file: RustDesk's says com.carriez.flutter_hbb (its GTK application id), and the Flatpak's desktop file is com.rustdesk.RustDesk. A profile recorded that id, so it couldn't relaunch the app (PR #16 keeps that from killing ft-floatd's socket). And the window's pid is the sandbox's own, so a launched window matched neither by process nor by app id, and didn't float. desktop_name() finds the desktop file whose StartupWMClass names the window's class (or app id) when the app id has none. Capture records that name, a profile claims open windows by it, and a launch's window matches by it. Profiles saved before this keep the old id; save them again. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: check the tracking cameras before recording, and watch for losing them After the headset wakes, XRService sometimes fails to load the colour module's VCINT FPGA image; then only the two side cameras run, without the IR light, and the tracker finds no hands. hands/camcheck.py reads XRService's log, the video nodes it holds and ft-camd's ring, and says ok, degraded or unknown. The recorder won't start while degraded (--ignore-cameras overrides it), offers a confirmed SteamVR restart, and stops the first hand-size step when the tracker sees no hand at all. ft-camwatch (unit file only, not enabled) follows the log, notifies, and with CAMWATCH_AUTO_RESTART=1 restarts SteamVR when the headset isn't worn and nothing else uses VR. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: shorter recording sessions with pose sweeps The second real session took 16 minutes, half of it 36 still poses. Labels come from the auto-labeller, so what matters is variety, not clean holds. A sweep step shows a strip of pose pictures and lights one every 4 s while the hands move slowly near and far; each cue is a prompt event with "cue": true. The core session is now 15 steps, about 5 minutes recorded. The pose groups, the one-hand sweeps' groups and the cue order are shuffled per session, seeded from its id and saved in session.json. A quick round (--quick, or the checklist's choice) is about 2 minutes for extra lighting. Touch the dot has 6 dots, the push sections two heights. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Input relay test: let the fake devices past the udev permission check Since the relay leaves a node it can't read yet for the next scan (12f2e84, PR #12), it checks os.access first, and the test's fake /dev/input paths don't exist, so the relay never opened them and every key check failed. The fake os now says they're readable. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pause Frametop for VR games Frametop kept using the headset during games: with gaze mode off, our eye tracker still took about 60% of a core, remote desktop about 2 cores while on, and KWin kept drawing hidden screens because ft-screens sent their frame callbacks at 90 Hz. Pausing gives that back, and resuming brings back only what pausing stopped. It's also a way to keep the gaze service and our eye tracker off during games, which PR #13 asked for. Paused (input/game_pause.py, run by the input relay): - frametop-gaze stops (ft-eyegrab then idles by itself), and hand tracking and remote desktop stop if they run - the desktop hides and slows down: ft-screens "pause on" hides every panel and sends KWin a frame callback once a second; or, with pause_desktop "close", the desktop closes and starts again on resume - the relay lets go of the 3D mouse, typing goes to Steam, and mapped buttons and key combinations do only pause_toggle, steam_menu and commands Toggled by both thumbsticks clicked together twice (configurable), read passively from vrserver's web socket (input/vrws.py) so it works in games and takes nothing from them; by the new pause_toggle action; by input/ft-pause; and, with pause_auto (default on), by a VR game starting and ending, which the pointer helper now reports ("vrgame 1|0"). Frametop Input Settings has a Games page for it. update-check.py checks the web socket, and doesn't count a paused gaze service as failed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: ft-hands works out which side camera is which ft-camd tells the side cameras apart by XRService's buffer allocation order, which some XRService starts reverse; both of 2026-10-02's starts did, so the cutouts missed the hands. HANDS_SWAP_SIDES=auto (the default) has ft-hands vote from hands seen in both side cameras: the landmark rays meet in front of both cameras only under the right naming. While undecided it probes the exchanged naming with the landmark model. It decides in about 2 s of hands (right on all 7 recordings replayed), swaps the views in place, and publishes sides.json. 0 and 1 still force it, with a warning when the hands disagree. Recordings carry each part's naming and the session's decision; review, export, validate and ft-handreplay put the names right, and takes.py sides records a decision by hand. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: idle while the gaze isn't used The gaze service ran ft-gaze and our own eye tracker all the time: with gaze mode off, ft-eyes still took about 60% of a core, and ft-eyegrab, ft-gaze and ft-gazed 3 to 4% each. Now ft-gaze and our tracker run only while gaze mode is on and someone wears the headset, while a check or the calibration is open or asked for, or under a "wake" lease, which the Gaze page of Frametop Input Settings renews while it's open. 30 s after the last use they stop, and the frame grabber idles with our tracker. - The pointer helper answers "gaze ? headset" with worn|away (SteamVR's activity level for the headset); an older helper answers it as before, and the service then goes by gaze mode alone. - A quick check, calibration, or fit check asked for while idle wakes the tracker and opens once it sends; the automatic calibration waits quietly while it starts. - Status has "awake" and "idle" (why), and the Gaze page shows it. - gaze/test/idle-test.py runs the service with a fake helper and ft-gaze, offline. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * update-check: a still controller isn't a broken web socket vrserver sends a controller's state only when something on it changes, and one lying still or asleep may not even send its first one. The check subscribed to one controller and failed after 3 s of silence. It now subscribes to all, and silence after a good handshake is a skip. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the recorder measures the light itself The checklist page measures the light when it opens, starting ft-camd if nothing runs it (and stopping it on quit), instead of saying the cameras aren't running. The round's lighting defaults to what the cameras measure: daylight or indoor, from the mono cameras' ambient infrared. Lamps give off little infrared, so dim and normal rooms read alike; picking dim, room or daylight still overrides it. session.json gets source, measured and ambient_ir. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: the recorder's host commands run from the home folder host-spawn starts a host command in the caller's folder. Started from /tmp, the app's folder in the container is /run/host/tmp, which the host doesn't have, so starting ft-camd (and every other host command) exited 127. host_command now runs from home (env -C), and the launcher cds there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Input Settings: the Games page is Game optimization Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: push steps say to follow the hollow circle, not the blue dot The dot is the current tracker's distance guess, often wrong; the ring is where the hands should be. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Eye tracker: one thread for OpenCV and numpy Nothing called cv2.setNumThreads, so OpenCV kept a pool of one worker per core for pupil windows of 140 to 240 px. Live, its idle workers spun and yielded about 14,000 times a second each, about a quarter of a core, next to SteamVR's compositor. numpy's OpenBLAS also started 8 threads that never had work. eyes_pupil.py now sets OpenCV to one thread, and ft-eyes sets OPENBLAS_NUM_THREADS and OMP_NUM_THREADS to 1 before numpy loads (a value already in the environment wins). Replaying fit1 into a scratch share (ft-eyes-replay, 14 s measured, capped at one core with the replay): threads 13 -> 1, involuntary context switches 3,812/s -> 430/s, system time 6.9% -> 1.6% of a core. Under that cap the frames it kept up with went from 21-36 to 57-69 a second per eye. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer: read the overlay list every 20 s, not every second The helper ran `vrcmd --overlays` once a second while the pointer was awake, and in gaze mode the pointer never sleeps. Each run is a shell plus vrcmd, a new SteamVR client, about 26 to 30 ms of CPU, so about 3% of a core all the time. The list is now read every 20 seconds, and at once (at most once a second) when it may have changed: the pointer waking, the dashboard opening or closing or creating an overlay, the scene app changing, an "overlays" request, and a left click that hit nothing, which may be on a panel that came up since. The thread waits on a condition variable instead of waking every 100 ms, so it sleeps while paused. The main loop looks the keys up again as soon as a new list is in, rather than at its next 1 s tick. Overlays already on the list still show and hide within 50 ms, from the IsOverlayVisible poll. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: ft-eyes and ft-gaze below SteamVR's priority ft-eyes and ft-gaze run in the dev container through distrobox, so they live in podman's libpod scope: frametop-gaze.service's limits never reach them, and they ran at nice 0 next to vrcompositor and vrserver, also at nice 0. - ft-eyes sets itself to nice 10 and SCHED_BATCH at start, before its threads. Batch turns off wakeup preemption, so a frame ft-eyes wakes up for can wait out a running compositor's turn; a few ms late costs the gaze little. - ft-gaze sets nice 5 before its threads start, but stays SCHED_OTHER: each sample goes on to the pointer, and batch would add the same wait to every one of them. - Both only ever lower their priority (a higher nice already set wins), and a failure is logged and ignored. Checked in the dev container: nice 0 -> 10, policy 0 -> 3 (SCHED_BATCH) without any capability. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer: sleep on the command socket while the pointer is off The main loop slept a fixed 8 ms, about 116 wakeups a second, whether the pointer was awake or not, and every second it looked up every overlay's handle and read a string property from all 64 device slots to find its own device. With the pointer off and hand gestures off, the loop now waits in poll() on its command socket for up to 250 ms, or 20 ms while mapped Frame controller buttons are being read (SteamVR input has no event to wait for). A mouse command ends the wait at once. The headset's activity level, the game check, and the "vrgame" and "gazeawake" repeats keep going at that pace. The 50 ms visibility poll and the 1 s handle lookups run only while the pointer is awake, and waking forces both. The device index is looked for only while it's unknown, and again after SteamVR activates or deactivates a device. The HMD pose history is kept only with hand gestures on, its one user. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Remote desktop: connect FreeRDP only while a VNC viewer is connected vnc-bridge.sh kept FreeRDP connected to krdpserver from the moment remote desktop started, so krdp captured and H.264-encoded every KWin redraw in software (openh264) with nobody watching: krdpserver 55-78% of a core, xfreerdp 16-27%, Xvnc 6-11%, with 0 clients on :5900. krdp 6.7 creates its screencast session per RDP connection and drops it when the connection closes, so krdpserver itself idles without one and stays up. The bridge now counts established connections to Xvnc's port with ss, starts FreeRDP when a viewer appears (the desktop shows about 3 s later; the VNC screen is black until then) and stops it 45 s after the last one leaves (VNC_IDLE_SEC). Xvnc has no client hook, so its log output, which it writes for every connection, wakes the bridge early; otherwise it looks every 5 s while idle (0.1% of a core measured, against 0.9% for ss once a second) and every second while FreeRDP runs. The layout check runs only while FreeRDP runs. While a viewer is connected the bridge sends "watch 15" to ft-screens (@ft_screens) at once and every 5 s, so screens at a reduced frame rate (out of view, headset on a stand) stream at full rate; it lapses by itself if the bridge dies, and an ft-screens without the command just answers an error. The window search after starting FreeRDP now ends when FreeRDP exits instead of polling for 30 s. krdp on 127.0.0.1 with a fresh password, VNC on the tailnet address with VncAuth, and remote-ctl.sh start/stop (pause and resume) are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Remote desktop: read the layout only after it changes While FreeRDP ran, vnc-bridge.sh called ft-layout remote-view every 5 s, which scans all of /proc for plasmashell and runs kscreen-doctor -j: about 4.4% of a core for a layout that rarely changes. It now stats the two files the answer depends on, the nested KWin's ~/.config/frametop/kwinoutputconfig.json (positions, scales, primary) and ~/.config/frametop-layout.json (screen sizes), once a second while FreeRDP runs. After either changes it reads the layout every 2 s for 10 s, since KWin's outputs follow the file a few seconds later; otherwise once a minute, in case a change touched neither. With no VNC viewer connected nothing runs (previous commit). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Eye tracker: ft-eyes sleeps until the next frame is due ft-eyes looked for new frames about 1,000 times a second: each pass of its loop asked the control socket with a non-blocking recvfrom (a BlockingIOError nearly every time), read both cameras' counters, and slept 1 ms. The frames come every 11.1 ms per camera, and only as counters in ft-eyegrab's shared memory, so there's no fd to wait on. Now each pass ends in select() on the control socket, with a timeout until 2 ms before the next frame of either camera is due (from when its last one was seen), then every 1 ms until it comes. A command wakes it at once. A camera with no frame for 0.1 s (headset off, grabber idle) isn't waited for, and with both stopped it looks every 20 ms. Waiting for the frame grabber's file uses the same select, 0.2 s at a time, instead of sleeping through commands. A new frame is still seen within about 1 ms of when it lands. On a synthetic share at 90 Hz per camera, on a heavily loaded headset (load average 23, so ft-eyes rarely sat idle), its waits went from 178 to 81 a second; unloaded, the old loop's 1 ms sleeps add up to about 1,000. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Screens: frame rates by attention, ticks in step with the display ft-screens gave KWin a frame callback for every committed screen on each tick, and the tick was an 11 ms timer set again after each run, so it slid through the display's frame and came about 85 times a second at 90 Hz: the desktop repeated a frame several times a second (judder in scrolling and video), and KWin drew every screen in one burst at a random point of vrcompositor's frame. Hidden screens got the same 90 Hz unless Frametop was paused for a game. - Ticks run on a timerfd at absolute times, once per display frame, 1 ms after the vsync (IVRSystem::GetTimeSinceLastVsync and the HMD's display frequency, read once a second), so KWin gets its callbacks early in the frame. Measured with --no-vr: 91 wakeups a second instead of about 85. On the Frame the vsync times SteamVR reports lie on a 90 Hz grid. - Each screen's callbacks come at a rate for how much of it you see (vr.cpp, UpdateAttention): every frame while focused (within 12 degrees of where your head points, a laser or the mouse on it in the last 1.5 s, carried, or typed on), 15 a second for the rest of what you see (within 60 degrees), and 1 a second when hidden, behind you, or paused. Levels rise at once and fall after 1.5 s (focused) or 0.5 s (in view). KWin draws a screen only after its callback and its apps wait for theirs, so this throttles the apps too. A screen where nothing changes costs nothing at any rate, as before. - A video in view keeps every frame: 8 commits in a row that each redraw 6% or more of the screen, at 10 a second or more, count as one (from the surface's buffer damage). - "rates F V H" / --rates set the three rates (default 0 15 1, 0 = every frame), "rates?" shows them and each screen's level, "watch S" gives everything full rate for S seconds for a remote viewer (vnc-bridge.sh renews it), and "phase MS" moves the ticks for tuning. - ft-screens' main thread runs at nice -5 after the session starts: SteamOS allows down to -8 once the soft RLIMIT_NICE is raised, and KWin waits on these ticks. It had spent nearly 3 times as long waiting to run as running. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer: skip unchanged work while the pointer is awake Every frame (about 116 a second) the helper tested the cursor ray against every visible overlay twice with ComputeOverlayIntersection, set the dot's alpha, width, transform and visibility (five calls into SteamVR), and sent the driver a pose datagram, even with the mouse and the head still. Now a frame reuses the last collision result when the mouse, the anchor (1 mm) and the eye (5 mm) haven't moved and no overlay showed, hid, or changed handle. The passes still run at least every 100 ms, since overlays move on their own (a floating window's controls follow it), and always while dragging. The dots' setters go to SteamVR only when their value changes: the placement when the dot moved 0.2 mm or the eye 5 mm, which turns or resizes it by well under 1%, and the width on a 0.5% change. The plain pose goes to the driver only when the laser's origin moved 0.2 mm or its direction 0.04 deg (0.1 mm where it lands, 15 cm on), and at least every 100 ms; the driver keeps the last pose and reports it every frame. A tilt's pose, a placement, or waking sends the next one regardless. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Session: blur, background contrast and animations off by default The nested kwinrc had no [Plugins] group, so KWin ran its default blur and background contrast effects, and kdeglobals had no AnimationDurationFactor, so animations ran at full length. KWin renders through zink on Turnip, on the GPU vrcompositor needs, and blur re-renders what's behind every translucent panel and menu; each animation frame is another frame for KWin and ft-screens. Before KWin starts, the session script now writes [Plugins] blurEnabled=false and contrastEnabled=false to $XDG_CONFIG_HOME/kwinrc and [KDE] AnimationDurationFactor=0 to its kdeglobals, each only if the desktop's own file has no value for it. It does this once and records that in $XDG_CONFIG_HOME/frametoprc ([Defaults] effects=1), because System Settings deletes a key put back to its default: without the marker, turning blur back on wouldn't survive a restart. The ids blur and contrast are the built-in effects of KWin 6.2.5 on SteamOS (both enabled by default in its plugin metadata). Tested against a temporary XDG_CONFIG_HOME: fresh config, an existing blurEnabled=true kept, and a deleted key not rewritten. README and docs/reference.md say how to turn them back on. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Session: don't autostart Discover's notifier or IBus in the desktop The nested Plasma session runs the system's XDG autostart entries. Discover's update notifier (/etc/xdg/autostart/org.kde.discover.notifier.desktop) started plasma-discover --mode update inside it, 520-620 MB resident and about 9% of a core, with flatpak-system-helper and AppStream downloads behind it. IBus started a nested ibus-daemon with kimpanel and ibus-extension-gtk3, which no app in the desktop can use: KWin's input method is ft-textinput (zwp_input_method_v1, focus reports only; the VR keyboard types through ft-screens' seat), and the session already drops QT_IM_MODULE, GTK_IM_MODULE and XMODIFIERS. Nothing in Frametop talks to IBus. Before Plasma starts, the session script copies both entries into $XDG_CONFIG_HOME/autostart with Hidden=true, which plasma-session honours for that desktop only. It does this once ([Defaults] autostart=1 in frametoprc) and skips a name the user already has a file for, so deleting the copy brings the program back. The geoclue demo agent stays (it answers apps' location requests outside GNOME and idles at 0%), and orca's entry is OnlyShowIn GNOME-family desktops, so it never ran. Tested against a temporary XDG_CONFIG_HOME, including an existing user ibus.desktop left alone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Input relay: never block on the pointer helper's socket The relay sent to @ft_pointer_helper on a blocking socket. When the helper stalled, a layout placement or grabprobe holds it for seconds while ft-gazed keeps filling its socket at 90 Hz, the relay's one loop blocked with it: keyboards, the volume keys (which must never reach gamescope), and pausing all stopped until the helper read again. The socket is non-blocking now. A command the helper doesn't take (EAGAIN) waits in a queue, and everything after it queues behind it so the order holds; tick() sends what it can on each loop, and the select timeout drops to 20 ms while anything waits. Mouse moves add up into one queued move. A scroll notch is dropped rather than queued, since scrolling seconds late is no use; its release still goes. Presses, releases, show, hide, and the rest are kept, so no button stays down. The queue holds at most 512 commands. While paused, the configured pointer's queue still drains, so the releases and "hide" from standing down arrive. A "vrbind" that hits a full socket is sent again on the next loop instead of being lost. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer driver: parse outside the lock, report only changes Handle() held the state lock through a chain of up to a dozen sscanf calls per command, and RunFrame, which vrserver calls every frame, takes the same lock, so a burst of commands (about 116 poses a second, plus moves and buttons) could hold up vrserver's frame. Commands are now parsed into locals first, and the lock is held only to store the result. RunFrame also called UpdateBooleanComponent six times and UpdateScalarComponent twice every frame, and TrackedDevicePoseUpdated every frame even while disconnected. Components now go to SteamVR only when they change (all of them on the first frame). The pose still goes out every frame while the device is connected, as a tracked device's should; the disconnected pose goes out once. The helper now sends a pose only when it changes, so the comment says the driver keeps the last one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * ft-powerd: ask SteamVR every 100 ms, not on every input event The loop polled the input devices with a 100 ms timeout and then, on every wake, did SteamVR's part: PollNextEvent, the headset's activity level and every device's pose, all IPC calls to vrserver. Input wakes it at once so the displays come on with the first key or motion, but a moving mouse sends hundreds of events a second, so moving the mouse meant hundreds of rounds of IPC a second instead of 10. Every wake still drains the input devices and the control socket and counts input as use straight away; SteamVR's part, and the backlight read that goes with it, now run only when 100 ms have passed since the last time, and poll sleeps until then. Built in the dev container (power/build.sh, no warnings); not run, since the live ft-powerd holds @ft_powerd. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Eye tracker: ft-eyegrab checks only the slot each camera writes next While copying, ft-eyegrab woke every 300 us (about 1,500 to 3,000 times a second) and fingerprinted all eight slots each time: 8 x 256 strided reads from DMA-BUF memory. - Each look now checks only the slot each camera writes next. The order is known (camera 0 3,0,1,2; camera 1 7,5,4,6,5,7,6,4), and the next slot follows from the last two; the table starts from those orders and learns from every frame, so a SteamVR update that changes them costs a few seconds of full scans, not frames. - A camera with nothing in its expected slot 1.5 frames after its last one, or with no order yet, gets all four slots checked, as before. A frame that turns up in an unexpected slot means full scans for that camera for 2 s. - A slot's fingerprint is taken again when it stops being one of the two in use, so a later check sees only a new frame. A frame is still passed on when its camera starts the frame after next. - Between frames it sleeps until 2.5 ms before the next is due, then looks every 1 ms, with 0.5 ms of timer slack (PR_SET_TIMERSLACK, --share only). With no frames from either camera for 0.5 s (headset off) it looks every 4 ms. - --rec keeps its 0.3 ms polls (and the expected-slot checks), for its timestamps. Tested offline by building poll_frames against simulated cameras that write each frame in four bursts, the last after the next frame starts (6 s, both cameras): 1,076 frames passed on, none torn or skipped, with the known orders and with camera 1 in a different order. Wakeups 1,486/s -> 207/s, the poller's CPU 3.6% -> 0.8% of a core (in plain memory; the real DMA-BUF reads cost more), and a frame's start is seen 1.35 ms after it begins on average instead of 0.76. With a camera stalling 15 ms every 2 s, the old poller passed on 22 torn frames and the new one 8 or fewer. Built (glibc 2.38 symbols at most, the host has 2.39), not installed: it runs as root from /etc/frametop, so it takes effect only after gaze/tracker/install.sh (sudo). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: upload from the headset, then plug in and leave it Export and upload are done in the headset now: the export page only notes that VR may stutter a little. Upload opens the pull request first (a draft) and shows its link, telling the person to plug in the headset and leave it until it says Uploaded; the files then go to refs/pr/N, and the pull request is marked open at the end. A retry of the same export goes on in the same pull request. While an export or upload runs, a host unit holds a logind sleep inhibitor so the Frame stays awake with the headset off. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Remote Access: check the status every 5 s instead of every 2 s While its window was open, Frametop Remote Access ran remote-ctl.sh status every 2 s, and each run spawns bash, curl (the tailnet name from tailscaled) and python3 to parse it. It now checks every 5 s, plus when the window comes to the front and once more 2 s after turning remote access on or off or changing the password, so a change still shows within a couple of seconds. A check doesn't start while one is still running. Doing the check in-process would duplicate remote-ctl.sh's idea of "running", which the session and the pause code share. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * update-check: KWin's blur and contrast effect ids, retest hints The session now turns KWin's blur and contrast effects off by id (blurEnabled and contrastEnabled in the desktop's kwinrc), and a KWin that renamed them would quietly leave them on. The check looks for their built-in factories (KWin::blur_factory, KWin::contrast_factory) in kwin_wayland, which it already reads for --output-count, and warns if one is gone. The kwin and plasma-workspace retest hints gain the blur and the hidden autostart entries. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pause gesture: look the controllers up every 30 s, not every 3 s The gesture reader fetched vrserver's /input/getstate.json over HTTP every 3 seconds, the whole time the relay runs, to notice a controller's root path changing when the 3D mouse takes or gives back its hand role. It now looks them up when it connects, when a message comes from a device path it doesn't know (at most every 3 s; the device is read from the message with two string searches, not a JSON parse of all 160 a second), 1.5 s after the relay's 3D mouse connects or lets go (the relay tells it through GamePause.controllers_changed), and otherwise every 30 s. The keys test's pause stub gets the new method. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Input relay: send mouse motion at most every 4 ms The relay sent the helper one "move" per SYN_REPORT, so a 1000 Hz mouse sent 1000 datagrams a second to a helper whose loop runs every 8 ms, and each one went through a dozen sscanf and strncmp tests in the helper before reaching the move handler. In a 200 ms test at 1000 Hz, 149 reports now make 45 moves with the same total. flush() on a report now sends only once 4 ms have passed since the last move; tick() sends the rest when due, and the select timeout shrinks to match. Buttons and the gaze keys still flush first, unconditionally, so a click lands where the pointer was. In the helper, "move" is now tested first in the command dispatch, and its handling is one lambda. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: ft-gaze prints and reads only the sources in use ft-gaze computed and printed all six sources for every sample: about 1.3 KB of JSON a line with our tracker (practice2), 120 KB a second through podman's stdio relay for ft-gazed to json.loads 90 times a second. It also read SteamVR's gaze action for every sample outside games (UpdateActionState and GetEyeTrackingDataRelativeToNow, two calls into vrserver, 180 a second), though with our tracker ft-gazed only uses own and mmap1. - ft-gaze takes --sources LIST (action, mmap1, mmap2, left, right, own, and eye for the EYE object; all by default, so the probe and ft-eyes-session are unchanged), and with --watch-stdin a line "sources LIST" on stdin switches them. A source left out isn't read and prints as {"ok":0} ("eye" as null), so every line keeps the same keys. An older ft-gaze ignores both, and prints everything as before. - ft-gazed asks for what it reads: own,mmap1 with our tracker; left,right,mmap1 with SteamVR's eyes; the source plus mmap1 and mmap2 on the older one-source path. While a check or the calibration runs or waits to open, all of them, since checks record every source (the calibration fits the action's correction too) and the fit check reads "eye". It switches as soon as that changes, well inside the check's 0.45 s settle. - So the action is read only during checks, or with --source action. On recorded samples, a line with own and mmap1 is about 700 bytes instead of 1,300 (practice2), and one with left, right and mmap1 about 550 instead of 940 (test1). gaze/test/idle-test.py now checks that ft-gaze starts with every source for a check and is then switched to those in use, without the action or own; all its checks pass. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer: don't put a vanished panel back in the visibility map The panel-edge test read visible[edgeKey], and when the last panel the cursor touched was gone from the overlay list, that added it back as hidden. The map then had more entries than there are handles, which made the 50 ms visibility poll run every frame, and since the last commit it also counted as a visibility change each time, so unchanged frames were never reused. The edge test now looks the key up without adding it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: ft-gaze's loop runs every 4 ms instead of 2 ft-gaze's loop slept 2 ms, so 500 times a second it read the head pose (GetDeviceToAbsoluteTrackingPose), checked the eye tracker's counter, and drained SteamVR's events, for samples that come 90 times a second. It now sleeps 4 ms. A new sample is printed within 4 ms of appearing, 2 on average (was 1), and the pose history still has a pose within 2 ms of any sample's time, which keeps the head-pose error under 0.2 degrees for a head turning 100 degrees a second. Sleeping until the next sample is due would have thinned the pose history to 11 ms. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Gaze: the hidden panel waits for a command instead of waking every 50 ms The calibration panel runs for as long as the gaze service does, hidden nearly all the time, and it woke 20 to 30 times a second to look at its socket and SteamVR's events: about 0.9% of a core, the main cost left with gaze idle. It now waits in poll() on its command socket: up to a second while hidden, and up to 10 ms while shown, as before (it still drains SteamVR's events each pass, so a quit is acknowledged within a second while hidden). A command wakes it at once, so "show" draws sooner than before. With --watch-stdin, its stdin closing wakes it as well, so stopping it doesn't wait. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Pointer: ft-screens announces new panels to the helper The helper now reads SteamVR's list of panels every 20 s instead of every second, so a panel made in between (a floating window's menu, frametop.float.N.sub.K, or the Frametop keyboard the first time it opens) couldn't be clicked with the mouse until the next read. ft-screens now sends "overlay <key>" to @ft_pointer_helper right after it makes one, and the helper adds it to its list at once (only frametop.* keys). An older helper ignores it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Hands: fix Export doing nothing, and show it's busy at onceaf2ea7cput _stay_awake between exportSession and its @Slot, so the window's Export button called a method QML couldn't see. A new test checks every backend call in main.qml against Backend's slots and properties. Export and Upload now say Exporting…/Uploading… with a spinner the moment they're pressed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Lazy susan: Meta+Alt+Tab spins the panels around you - ft-screens "spin next|prev|<degrees>": every unpinned screen and floating window turns together about a vertical axis through your head (0.3 s, eased), so the next panel on the right or left comes to straight ahead; the arrangement stays as it is. Taps during a spin add to it, from where the panels are headed; grabbing a panel or placing it (ft-layout, ft-floatd) takes it out of the spin - when a spin settles, the panel in front gets the pointer (recenter), typing (as after a click), and KWin's active window: its floating window, or the top window on a screen (ft-floatd "front N", the KWin script's activate-output). KWin's outputs follow the screens' new places (ft-layout scale), as after a move - the input relay: spin_next and spin_prev actions, Meta+Alt+Tab and Meta+Alt+Shift+Tab by default; Frametop Input Settings lists them. Not Meta+Tab: that's Cmd+Tab on a Mac reached through a remote desktop like RustDesk, and the relay would take the Mac's app switcher. Meta+Alt+Tab (Cmd+Option+Tab) is unused on macOS, Windows, and KDE Used on the Frame (SteamOS 0.3.0 build 20260922) with one screen and three or four floating windows, through RustDesk to a Mac. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * hand recorder: login command works from Frametop's Konsole Frametop's Konsole sets XDG_RUNTIME_DIR=/run/user/UID/frametop, where podman finds no container state, so 'distrobox enter dev -- hf auth login' failed with a crun error. The command the Upload page shows now sets the real runtime folder. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * hand recorder: log in from the Upload page, three-step page, no terminal The Upload page is now three numbered steps: choose the export, log in to Hugging Face, upload. Log in runs hub.py login, huggingface_hub's browser login (OAuth device code, as hf auth login does): the link opens in the browser and the page shows the code to enter, with Copy code and Cancel. hub.py saves the token; the window never sees one, and nobody pastes one. The terminal upload and the login command are gone from the page, and UPLOAD.md is now a short 'About uploading' under the steps. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * hand recorder: take.json keeps camera clock samples sets.bin's capture_ns is CLOCK_MONOTONIC_RAW; poses.jsonl and prompts.jsonl are CLOCK_MONOTONIC. On 2026-10-03 the two were 0.80 s apart during a session and 1.11 s apart five hours later, so images can't be paired with poses by capture_ns. take.json now samples RAW minus MONOTONIC as each recording part starts and stops (as ft-hands' raw_minus_mono_ns), so readers can put each exposure on the poses' clock. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * hand recorder export: no controller poses without controllers, nothing in deleted ranges When the checklist says no controllers, exported poses.jsonl has left and right null and feedback lines carry no controller state: controllers left switched on still get tracked (one wandered 2 m in a real session) and would read as the hands' ground truth. Poses and live-tracker feedback inside deleted ranges are left out too, as the images there are. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * hand recorder: final consent text (2026-10-03), residency check, installer Consent 2026-10-03, after a non-lawyer review: who runs this and how to reach them, the dataset is public (Hugging Face, possibly abroad), the Hugging Face username shows next to the contributor id, purposes (no identification), safety, the maintainer grant passes to whoever maintains Frametop next, withdrawal before and after merge, rights such as the GDPR's, and what a new version means. Residents of Illinois, Texas and Washington can't take part for now (biometric privacy laws): a third checkbox, profile consent.region_ok, checked by validate.py from this consent version on. The DRAFT banners are gone, so uploads no longer need FT_HANDREC_ALLOW_UPLOAD. hands/rec/install.sh installs the recorder on a Frame with Frametop: container packages, hand tracking and panel builds, ft-camd's capabilities, menu entry. test_qml_backend also checks each call's argument count against the slots. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Screens: a reset button next to the grab bar, clickable in VR games Each desktop screen gets a reset button left of its bar (a reticle). It puts every screen back in its layout around where you are now, like Meta+Shift+R (ft-layout apply). In a VR game the screens leave the controllers to the game (the outside_games and dashboard modes), so a controller couldn't click any of their controls. Aiming a hand controller at the reset button now sets MakeOverlaysInteractiveIfVisible on that button's overlay alone, so the trigger clicks it; the flag clears half a second after the aim leaves a zone twice as wide, and the game gets the controllers back. The aim comes from the laser poses ft-screens already reads to show the controls. The ft-layout spawn is now RunLayout(cmd), shared with the arrange. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Click stability: 32 logical pixels by default, not 8 8 is about 0.2 degrees on a 3.4 m wide 3440-pixel screen 2 m away, so a trigger press turned into a drag unless the hand was very still. 32 (about 0.9 degrees) felt much better in the headset (2026-10-03). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Screens: in games, pointing a controller at a panel turns its laser on SteamVR's own floating windows take the laser while a controller points at them in a game and give it back when it points away. Frametop's panels didn't: with the controllers left to the game (outside_games, the default, or dashboard), they couldn't be clicked without the dashboard. ft-screens now sets MakeOverlaysInteractiveIfVisible on a screen or floating window while a hand controller's laser pose meets it, its controls, or its popups (UpdateAim; curved screens hit on their cylinder), and clears it 0.3 s after the aim leaves a wider margin. A drag or a held button keeps it on. The keyboard, one overlay, uses ComputeOverlayIntersection and now follows the mode when a game starts or ends while it's open. This replaces the reset button's own aim zone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Screens: find the controllers' laser tip during VR games too GetComponentStateForDevicePath with no input source handle fails for every render model component while a VR game runs (checked 2026-10-03 with a game up: all 21 components of frame_controller_right). TipOffset then fell back to the controller's pose, which aims 40 degrees above the Frame controller's laser. In games, pointing at a screen's middle missed it and pointing below it hit, so the new aim-to-laser only worked from the bottom; the controls' reveal and pin/roll aim were off the same way. GetComponentState still answers then, with the same tip. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * input-relay: Add mute key as volume key Add KEY_MUTE as volume key. It will be mapped to KEY_MACRO28 and use wpctl to toggle the mute of the default audio sink. The toggle of the mute state will be done once when the key is pressed instead of continuously toggling it when it is held down. This allows the mute button on keyboards to work properly. Signed-off-by: SuperTuxii <123881249+SuperTuxii@users.noreply.github.com> * Session: bring back a taskbar saved on a screen the desktop doesn't have Plasma 6.2.5 keeps a panel on a screen number and never moves one whose number is past the screen count, so a taskbar saved on a spare output (#18, lastScreen=8 with three screens) or on a screen a smaller layout dropped stayed hidden. Before Plasma starts, session/fix-panels.py moves such a panel and its tray's containment to screen 0 (the primary), keeping its widgets, unless screen 0 already has a panel on that edge. doctor.sh checks the panels' screens, and report.sh lists them with the live outputs and panels. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * keys-test: the spin bindings (Meta+Alt+Tab, Meta+Alt+Shift+Tab), not while paused Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Menu entries: own programs for Reset Screen Layout and Hide/Show Screens Reset Screen Layout and Hide/Show Screens both ran ft-layout. Steam lists entries by program, so Hide/Show launched Reset. Each gets a wrapper. From PR #17 (only this part of 9618be8; its host_command change is for the Nix packages). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Screens: release a held button that can't come up on a screen Pausing, or hiding the screen a button went down on, took the laser off it mid-click; the pause gesture's second thumbstick click does that. SteamVR's laser mouse then forgot the button ("Mouse down count is 1 but states are all false"), no release came, and the catcher kept showing whenever the pressing laser was off the panels, even while paused. Being interactive, it kept the VR game's controllers from it until the desktop restarted (2026-10-04, Beat Saber). ft-screens now releases a held button when it's paused, when the screen it went down on is hidden, or, during VR games, when the pressing hand controller has held nothing for a second. GetControllerState answers overlay apps only while a game runs; outside games a hold is never cut. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Signed-off-by: SuperTuxii <123881249+SuperTuxii@users.noreply.github.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Codex <codex@localhost> Co-authored-by: CuriousJ <curious.j.tuber@gmail.com> Co-authored-by: Patrick McDavid <fusionjunky@gmail.com> Co-authored-by: SuperTuxii <123881249+SuperTuxii@users.noreply.github.com> Co-authored-by: John Murray <5672686+JRMurr@users.noreply.github.com>
946 lines
46 KiB
C
946 lines
46 KiB
C
// ft-screens: a minimal Wayland compositor that hosts the nested KWin and shows each of
|
|
// its screens as its own SteamVR panel. It replaces gamescope for Frametop:
|
|
// - KWin (nested Wayland backend) opens one window per screen. We send each window its
|
|
// size (xdg_toplevel configure), and KWin resizes that screen to match, so every
|
|
// screen has its own resolution and shape (ultrawide, portrait, 4K...). gamescope
|
|
// never sized its windows and drew them all into one canvas of at most 1920x1080.
|
|
// - KWin renders into DMA-BUFs and hands them to us (linux-dmabuf). We draw nothing:
|
|
// each buffer goes to SteamVR as the panel's texture (vr.cpp, ImportDmabuf).
|
|
// - Pointer input from the panels (controller lasers, the 3D mouse) goes to KWin through
|
|
// our seat, as if we were a normal desktop. KWin's nested backend adds our surface
|
|
// coordinates to its output's logical position without undoing its own scale, and its
|
|
// buffers are in pixels, so a panel position in pixels is divided by the screen's KWin
|
|
// scale first ("scale <screen> <s>", from ft-layout).
|
|
//
|
|
// Usage: ft-screens [--socket NAME] [--control NAME] [--no-vr] [--screen WxH@METRES]...
|
|
// [--spares N] [--rates F,V,H] [-- COMMAND ARGS...]
|
|
// --socket Wayland socket name in $XDG_RUNTIME_DIR (default ft-screens-0)
|
|
// --control the control socket's abstract name (default ft_screens)
|
|
// --no-vr run without SteamVR, for tests next to the running desktop: no panels, no
|
|
// input, and nothing sent to the input relay. Commands still work, and
|
|
// "toplevels" shows what KWin opened.
|
|
// --screen one per screen, in KWin's order (default: 3440x1440@2.4)
|
|
// --spares KWin's outputs after the screens: spares for floating windows (ft-floatd
|
|
// turns them on and sizes them; see docs/floating-windows.md)
|
|
// --rates frame rates in Hz for screens you look at, the rest you see, and hidden ones
|
|
// (0: every display frame; default 0,15,1; see frame_interval)
|
|
// COMMAND run with WAYLAND_DISPLAY set to our socket (e.g. the Frametop session)
|
|
// Runs in the dev container (wlroots 0.20); KWin connects from the host.
|
|
#define _GNU_SOURCE
|
|
#include <drm_fourcc.h>
|
|
#include <linux/input-event-codes.h>
|
|
#include <signal.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <stddef.h>
|
|
#include <sys/socket.h>
|
|
#include <sys/resource.h>
|
|
#include <sys/stat.h>
|
|
#include <sys/timerfd.h>
|
|
#include <sys/un.h>
|
|
#include <sys/wait.h>
|
|
#include <time.h>
|
|
#include <unistd.h>
|
|
#include <wayland-server-core.h>
|
|
#include <xkbcommon/xkbcommon.h>
|
|
|
|
#define WLR_USE_UNSTABLE
|
|
#include <wlr/interfaces/wlr_keyboard.h>
|
|
#include <wlr/render/dmabuf.h>
|
|
#include <wlr/render/drm_format_set.h>
|
|
#include <wlr/types/wlr_buffer.h>
|
|
#include <wlr/types/wlr_compositor.h>
|
|
#include <wlr/types/wlr_data_device.h>
|
|
#include <wlr/types/wlr_keyboard.h>
|
|
#include <wlr/types/wlr_linux_dmabuf_v1.h>
|
|
#include <wlr/types/wlr_seat.h>
|
|
#include <wlr/types/wlr_shm.h>
|
|
#include <wlr/types/wlr_subcompositor.h>
|
|
#include <wlr/types/wlr_xdg_decoration_v1.h>
|
|
#include <wlr/types/wlr_xdg_shell.h>
|
|
#include <wlr/util/log.h>
|
|
|
|
#include "vr.h"
|
|
#include "controller-click.h"
|
|
|
|
#define MAX_SCREENS 24 // screens and spare outputs
|
|
// A screen counts as playing a video while its last VIDEO_COMMITS commits each redrew at
|
|
// least VIDEO_AREA percent of it, at VIDEO_HZ or more; for VIDEO_HOLD ms after that stops.
|
|
#define VIDEO_COMMITS 8
|
|
#define VIDEO_AREA 6
|
|
#define VIDEO_HZ 10
|
|
#define VIDEO_HOLD 1500
|
|
|
|
struct config {
|
|
int width, height;
|
|
double metres;
|
|
};
|
|
|
|
struct server;
|
|
|
|
// One KWin window = one screen.
|
|
struct screen {
|
|
struct server *server;
|
|
int index;
|
|
struct wlr_xdg_toplevel *toplevel;
|
|
struct wlr_buffer *held; // on the panel now; unlocked when the next one arrives
|
|
bool frame_pending; // a commit waits for its frame callback
|
|
unsigned commits; // buffers committed, and the last one's size ("toplevels")
|
|
int buffer_width, buffer_height;
|
|
struct wlr_xdg_toplevel_decoration_v1 *decoration; // answered on the first commit
|
|
struct wl_listener commit, destroy, decoration_destroy, set_title;
|
|
// Its frame rate (see tick): when its last frame callback went (ms), and what its recent
|
|
// commits looked like, to tell a video playing on it.
|
|
uint32_t frame_sent;
|
|
uint32_t commit_ms[VIDEO_COMMITS];
|
|
unsigned commit_at;
|
|
unsigned big; // a bit per recent commit: it redrew at least VIDEO_AREA percent
|
|
uint32_t video_until; // counts as a video until then (ms)
|
|
};
|
|
|
|
// Per client buffer: forget its import when it goes away.
|
|
struct tracked_buffer {
|
|
struct wlr_buffer *buffer;
|
|
struct wl_listener destroy;
|
|
struct wl_list link;
|
|
};
|
|
|
|
struct server {
|
|
struct wl_display *display;
|
|
struct wl_event_loop *loop;
|
|
struct wlr_seat *seat;
|
|
struct wlr_keyboard keyboard;
|
|
struct wlr_xdg_shell *xdg_shell;
|
|
struct wlr_xdg_decoration_manager_v1 *decoration;
|
|
struct wl_listener new_toplevel, new_decoration;
|
|
struct screen *screens[MAX_SCREENS];
|
|
struct config config[MAX_SCREENS];
|
|
double scale[MAX_SCREENS]; // KWin's scale for each screen (panel pixels per logical unit)
|
|
int n_config, n_screens; // n_config: the screens; the outputs after them are spares
|
|
int spares;
|
|
struct wl_list buffers; // tracked_buffer
|
|
struct wl_event_source *tick;
|
|
int tick_fd; // timerfd, at absolute times in step with the display's vsync (see schedule)
|
|
int64_t period_ns, base_ns, synced_ns; // the display's frame time, a tick time, last sync
|
|
double phase_ms; // ticks come this long after a vsync
|
|
// Frame rates in Hz for each attention level (0: every display frame), and a remote
|
|
// viewer's lease: until then (ms) every screen gets full rate ("watch").
|
|
int rate[3];
|
|
uint32_t watch_until;
|
|
uint32_t typed_ms; // the last key sent to the desktop: its screen counts as focused
|
|
struct screen *pointer_focus;
|
|
struct ft_controller_click controller_click;
|
|
pid_t child;
|
|
// Where typing goes: the screens after a click on one, Steam after a click on another
|
|
// panel. The input relay grabs the keyboards while it's the screens (see keys_update).
|
|
bool keys_clicked; // the last click was on a screen
|
|
bool keys_desktop; // ...and the screens are showing: typing goes to the desktop
|
|
int relay_fd; // unbound, so the relay can't reply into our control socket
|
|
uint32_t relay_sent; // when the relay last heard from us (ms)
|
|
unsigned ticks;
|
|
// Our keyboard ("vrkeyboard" commands from the input relay; see keyboard_command).
|
|
int kb_screen; // the screen it's open for, -1 closed
|
|
bool kb_auto; // opened for a focused text field (not by a button)
|
|
unsigned kb_close_at; // ticks: close it then (a text field lost focus), 0 not
|
|
bool vr; // connected to SteamVR (not --no-vr)
|
|
};
|
|
|
|
static uint32_t now_ms(void) {
|
|
struct timespec ts;
|
|
clock_gettime(CLOCK_MONOTONIC, &ts);
|
|
return (uint32_t)(ts.tv_sec * 1000 + ts.tv_nsec / 1000000);
|
|
}
|
|
|
|
// ---------------------------------------------------------------- buffers
|
|
|
|
static void buffer_destroyed(struct wl_listener *l, void *data) {
|
|
struct tracked_buffer *t = wl_container_of(l, t, destroy);
|
|
ft_vr_forget(t->buffer);
|
|
wl_list_remove(&t->destroy.link);
|
|
wl_list_remove(&t->link);
|
|
free(t);
|
|
}
|
|
|
|
static void track_buffer(struct server *s, struct wlr_buffer *buffer) {
|
|
struct tracked_buffer *t;
|
|
wl_list_for_each(t, &s->buffers, link) if (t->buffer == buffer) return;
|
|
t = calloc(1, sizeof *t);
|
|
t->buffer = buffer;
|
|
t->destroy.notify = buffer_destroyed;
|
|
wl_signal_add(&buffer->events.destroy, &t->destroy);
|
|
wl_list_insert(&s->buffers, &t->link);
|
|
}
|
|
|
|
// ---------------------------------------------------------------- screens
|
|
|
|
// A video (or anything moving over a large area) on a screen you don't look at keeps the
|
|
// full frame rate (see frame_interval): its commits keep redrawing much of it, and keep
|
|
// coming as fast as its rate lets them. A cursor blinking or a spinner turning redraws a
|
|
// small part, and a page changing now and then doesn't keep coming.
|
|
static void note_damage(struct screen *sc, struct wlr_surface *surface, struct wlr_buffer *buffer) {
|
|
int n = 0;
|
|
const pixman_box32_t *r = pixman_region32_rectangles(&surface->buffer_damage, &n);
|
|
int64_t area = 0;
|
|
for (int i = 0; i < n; ++i) area += (int64_t)(r[i].x2 - r[i].x1) * (r[i].y2 - r[i].y1);
|
|
const bool big = area * 100 >= (int64_t)buffer->width * buffer->height * VIDEO_AREA;
|
|
const unsigned all = (1u << VIDEO_COMMITS) - 1;
|
|
sc->big = ((sc->big << 1) | big) & all;
|
|
const uint32_t t = now_ms();
|
|
const uint32_t oldest = sc->commit_ms[sc->commit_at]; // the commit VIDEO_COMMITS ago
|
|
sc->commit_ms[sc->commit_at] = t;
|
|
sc->commit_at = (sc->commit_at + 1) % VIDEO_COMMITS;
|
|
if (sc->big == all && t - oldest <= VIDEO_COMMITS * 1000 / VIDEO_HZ) sc->video_until = t + VIDEO_HOLD;
|
|
}
|
|
|
|
static void screen_commit(struct wl_listener *l, void *data) {
|
|
struct screen *sc = wl_container_of(l, sc, commit);
|
|
struct wlr_xdg_surface *xdg = sc->toplevel->base;
|
|
if (xdg->initial_commit) {
|
|
// First commit: tell KWin the size of this screen.
|
|
const struct config spare = {640, 480, 0.5}; // until ft-floatd sizes it
|
|
const struct config *c = sc->index < sc->server->n_config ? &sc->server->config[sc->index] : &spare;
|
|
wlr_xdg_toplevel_set_size(sc->toplevel, c->width, c->height);
|
|
wlr_xdg_toplevel_set_activated(sc->toplevel, true);
|
|
if (sc->decoration)
|
|
wlr_xdg_toplevel_decoration_v1_set_mode(sc->decoration, WLR_XDG_TOPLEVEL_DECORATION_V1_MODE_SERVER_SIDE);
|
|
return;
|
|
}
|
|
struct wlr_buffer *buffer = xdg->surface->current.buffer;
|
|
static int logged;
|
|
if (logged < 6) {
|
|
++logged;
|
|
wlr_log(WLR_INFO, "screen %d: commit, buffer %p (%dx%d), mapped %d", sc->index + 1, (void *)buffer,
|
|
buffer ? buffer->width : 0, buffer ? buffer->height : 0, xdg->surface->mapped);
|
|
}
|
|
if (!buffer) return;
|
|
sc->frame_pending = true;
|
|
++sc->commits;
|
|
note_damage(sc, xdg->surface, buffer);
|
|
sc->buffer_width = buffer->width, sc->buffer_height = buffer->height;
|
|
if (buffer == sc->held) return;
|
|
struct wlr_dmabuf_attributes a;
|
|
if (!wlr_buffer_get_dmabuf(buffer, &a)) {
|
|
static bool warned;
|
|
if (!warned) wlr_log(WLR_ERROR, "screen %d: not a DMA-BUF (shm?); skipped", sc->index + 1);
|
|
warned = true;
|
|
return;
|
|
}
|
|
struct ft_dmabuf b = {.width = a.width, .height = a.height, .format = a.format, .modifier = a.modifier,
|
|
.n_planes = a.n_planes};
|
|
for (int i = 0; i < a.n_planes && i < 4; ++i) {
|
|
b.offset[i] = a.offset[i];
|
|
b.stride[i] = a.stride[i];
|
|
b.fd[i] = a.fd[i];
|
|
}
|
|
track_buffer(sc->server, buffer);
|
|
if (!ft_vr_screen_present(sc->index, buffer, &b)) return;
|
|
// Keep this buffer until the next frame replaces it, so SteamVR never samples a
|
|
// buffer KWin is drawing into; then let KWin have the previous one back.
|
|
wlr_buffer_lock(buffer);
|
|
if (sc->held) wlr_buffer_unlock(sc->held);
|
|
sc->held = buffer;
|
|
}
|
|
|
|
static void screen_destroy(struct wl_listener *l, void *data) {
|
|
struct screen *sc = wl_container_of(l, sc, destroy);
|
|
wlr_log(WLR_INFO, "screen %d closed", sc->index + 1);
|
|
if (sc->held) wlr_buffer_unlock(sc->held);
|
|
ft_vr_screen_destroy(sc->index);
|
|
if (sc->server->pointer_focus == sc) sc->server->pointer_focus = NULL;
|
|
if (sc->decoration) wl_list_remove(&sc->decoration_destroy.link);
|
|
sc->server->screens[sc->index] = NULL;
|
|
wl_list_remove(&sc->commit.link);
|
|
wl_list_remove(&sc->destroy.link);
|
|
wl_list_remove(&sc->set_title.link);
|
|
free(sc);
|
|
}
|
|
|
|
// KWin titles each window "KDE Wayland Compositor <output name>", with "- Output disabled"
|
|
// after it while that output is off.
|
|
static void screen_title(struct wl_listener *l, void *data) {
|
|
struct screen *sc = wl_container_of(l, sc, set_title);
|
|
const char *title = sc->toplevel->title ? sc->toplevel->title : "";
|
|
wlr_log(WLR_INFO, "screen %d: \"%s\"", sc->index + 1, title);
|
|
if (sc->index >= sc->server->n_config) ft_vr_float_output(sc->index, !strstr(title, "Output disabled"));
|
|
}
|
|
|
|
static void new_toplevel(struct wl_listener *l, void *data) {
|
|
struct server *s = wl_container_of(l, s, new_toplevel);
|
|
struct wlr_xdg_toplevel *toplevel = data;
|
|
int index = 0;
|
|
while (index < MAX_SCREENS && s->screens[index]) ++index;
|
|
if (index == MAX_SCREENS) {
|
|
wlr_log(WLR_ERROR, "more than %d screens; ignoring one", MAX_SCREENS);
|
|
return;
|
|
}
|
|
struct screen *sc = calloc(1, sizeof *sc);
|
|
sc->server = s;
|
|
sc->index = index;
|
|
sc->toplevel = toplevel;
|
|
s->screens[index] = sc;
|
|
if (index >= s->n_config) {
|
|
wlr_log(WLR_INFO, "screen %d: KWin window, a spare output (floating window %d)", index + 1,
|
|
index - s->n_config + 1);
|
|
ft_vr_float_create(index, index - s->n_config + 1);
|
|
} else {
|
|
const struct config *c = &s->config[index];
|
|
wlr_log(WLR_INFO, "screen %d: KWin window, %dx%d, %.2f m wide", index + 1, c->width, c->height, c->metres);
|
|
ft_vr_screen_create(index, c->metres, s->n_config);
|
|
}
|
|
sc->commit.notify = screen_commit;
|
|
wl_signal_add(&toplevel->base->surface->events.commit, &sc->commit);
|
|
sc->destroy.notify = screen_destroy;
|
|
wl_signal_add(&toplevel->events.destroy, &sc->destroy);
|
|
sc->set_title.notify = screen_title;
|
|
wl_signal_add(&toplevel->events.set_title, &sc->set_title);
|
|
}
|
|
|
|
// KWin asks for server-side decorations for its screens; we draw none. It asks before its
|
|
// first commit, when a configure isn't allowed yet, so the answer waits for that commit.
|
|
static void decoration_destroyed(struct wl_listener *l, void *data) {
|
|
struct screen *sc = wl_container_of(l, sc, decoration_destroy);
|
|
wl_list_remove(&sc->decoration_destroy.link);
|
|
sc->decoration = NULL;
|
|
}
|
|
|
|
static void new_decoration(struct wl_listener *l, void *data) {
|
|
struct server *s = wl_container_of(l, s, new_decoration);
|
|
struct wlr_xdg_toplevel_decoration_v1 *d = data;
|
|
for (int i = 0; i < MAX_SCREENS; ++i) {
|
|
struct screen *sc = s->screens[i];
|
|
if (!sc || sc->toplevel != d->toplevel) continue;
|
|
sc->decoration = d;
|
|
sc->decoration_destroy.notify = decoration_destroyed;
|
|
wl_signal_add(&d->events.destroy, &sc->decoration_destroy);
|
|
if (d->toplevel->base->initialized)
|
|
wlr_xdg_toplevel_decoration_v1_set_mode(d, WLR_XDG_TOPLEVEL_DECORATION_V1_MODE_SERVER_SIDE);
|
|
}
|
|
}
|
|
|
|
// ---------------------------------------------------------------- input from the panels
|
|
|
|
static void panel_key(struct server *s, uint32_t code, bool pressed);
|
|
|
|
static void handle_vr_event(const struct ft_event *e, void *data) {
|
|
struct server *s = data;
|
|
if (e->type == FT_QUIT) {
|
|
wl_display_terminate(s->display);
|
|
return;
|
|
}
|
|
if (e->type == FT_KEY) {
|
|
panel_key(s, e->key, e->pressed);
|
|
return;
|
|
}
|
|
if (e->type == FT_KEYBOARD_CLOSED) {
|
|
if (s->kb_screen >= 0) wlr_log(WLR_INFO, "keyboard closed");
|
|
s->kb_screen = -1;
|
|
s->kb_close_at = 0;
|
|
return;
|
|
}
|
|
if (e->screen < 0 || e->screen >= MAX_SCREENS || !s->screens[e->screen]) return;
|
|
struct ft_event filtered = *e;
|
|
if (e->screen < s->n_config &&
|
|
!ft_controller_click_filter(&s->controller_click, &filtered, s->scale[e->screen])) return;
|
|
e = &filtered;
|
|
if (e->screen < 0 || e->screen >= MAX_SCREENS || !s->screens[e->screen]) return;
|
|
struct screen *sc = s->screens[e->screen];
|
|
struct wlr_surface *surface = sc->toplevel->base->surface;
|
|
if (e->type == FT_FRONT) {
|
|
// A spin brought this panel to the front: typing goes to it, as after a click there,
|
|
// and ft-floatd makes its window (or the top one on a screen) KWin's active window.
|
|
wlr_seat_keyboard_notify_enter(s->seat, surface, NULL, 0, NULL);
|
|
s->keys_clicked = true;
|
|
char msg[32];
|
|
snprintf(msg, sizeof msg, "front %d", e->screen + 1);
|
|
struct sockaddr_un addr = {.sun_family = AF_UNIX};
|
|
const char name[] = "frametop_float";
|
|
memcpy(addr.sun_path + 1, name, sizeof name - 1);
|
|
sendto(s->relay_fd, msg, strlen(msg), MSG_DONTWAIT, (struct sockaddr *)&addr,
|
|
offsetof(struct sockaddr_un, sun_path) + 1 + sizeof name - 1);
|
|
return;
|
|
}
|
|
const uint32_t t = now_ms();
|
|
const double x = e->x / s->scale[e->screen], y = e->y / s->scale[e->screen]; // KWin's units
|
|
switch (e->type) {
|
|
case FT_MOTION:
|
|
case FT_BUTTON:
|
|
if (s->pointer_focus != sc) {
|
|
// KWin's nested backend ignores the position in wl_pointer.enter, and wlroots
|
|
// drops a motion to the position it entered at, so KWin would keep its old
|
|
// pointer until the next move: a press right after crossing onto another
|
|
// screen landed where the pointer had been. Entering one unit off makes the
|
|
// motion below go through.
|
|
wlr_seat_pointer_notify_enter(s->seat, surface, x + 1, y);
|
|
s->pointer_focus = sc;
|
|
}
|
|
wlr_seat_pointer_notify_motion(s->seat, t, x, y);
|
|
if (e->type == FT_BUTTON) {
|
|
wlr_seat_pointer_notify_button(s->seat, t, e->button,
|
|
e->pressed ? WL_POINTER_BUTTON_STATE_PRESSED
|
|
: WL_POINTER_BUTTON_STATE_RELEASED);
|
|
if (e->pressed) {
|
|
wlr_seat_keyboard_notify_enter(s->seat, surface, NULL, 0, NULL);
|
|
s->keys_clicked = true;
|
|
}
|
|
}
|
|
break;
|
|
case FT_SCROLL:
|
|
if (s->pointer_focus != sc) break;
|
|
if (sc->index >= s->n_config && e->dy != 0 &&
|
|
(wlr_keyboard_get_modifiers(&s->keyboard) & WLR_MODIFIER_LOGO)) {
|
|
// Meta+scroll on a floating window: its scale, bigger or smaller (ft-floatd).
|
|
char msg[48];
|
|
snprintf(msg, sizeof msg, "scale %d %d", sc->index + 1, e->dy < 0 ? 1 : -1);
|
|
struct sockaddr_un addr = {.sun_family = AF_UNIX};
|
|
const char name[] = "frametop_float";
|
|
memcpy(addr.sun_path + 1, name, sizeof name - 1);
|
|
sendto(s->relay_fd, msg, strlen(msg), MSG_DONTWAIT, (struct sockaddr *)&addr,
|
|
offsetof(struct sockaddr_un, sun_path) + 1 + sizeof name - 1);
|
|
break;
|
|
}
|
|
if (e->dy != 0)
|
|
wlr_seat_pointer_notify_axis(s->seat, t, WL_POINTER_AXIS_VERTICAL_SCROLL, e->dy * 15,
|
|
(int32_t)(e->dy * 120), WL_POINTER_AXIS_SOURCE_WHEEL,
|
|
WL_POINTER_AXIS_RELATIVE_DIRECTION_IDENTICAL);
|
|
if (e->dx != 0)
|
|
wlr_seat_pointer_notify_axis(s->seat, t, WL_POINTER_AXIS_HORIZONTAL_SCROLL, e->dx * 15,
|
|
(int32_t)(e->dx * 120), WL_POINTER_AXIS_SOURCE_WHEEL,
|
|
WL_POINTER_AXIS_RELATIVE_DIRECTION_IDENTICAL);
|
|
break;
|
|
case FT_LEAVE:
|
|
if (s->pointer_focus == sc) {
|
|
wlr_seat_pointer_notify_clear_focus(s->seat);
|
|
s->pointer_focus = NULL;
|
|
}
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
wlr_seat_pointer_notify_frame(s->seat);
|
|
}
|
|
|
|
// Tell the input relay where typing goes, on a change and every second: while it's the
|
|
// desktop, the relay grabs pass-through keyboards so SteamVR (and the Steam app with
|
|
// gamescope's focus) doesn't get the keys too. Without word from us for a few seconds,
|
|
// the relay gives the keyboards back, so a closed desktop doesn't keep them.
|
|
static void keys_update(struct server *s) {
|
|
if (!s->vr) return; // a test instance leaves the running desktop's keyboards alone
|
|
const bool desktop = s->keys_clicked && ft_vr_screens_shown();
|
|
const uint32_t t = now_ms();
|
|
if (desktop == s->keys_desktop && t - s->relay_sent < 1000) return;
|
|
if (desktop != s->keys_desktop) wlr_log(WLR_INFO, "typing goes to %s", desktop ? "the desktop" : "Steam");
|
|
s->keys_desktop = desktop;
|
|
s->relay_sent = t;
|
|
struct sockaddr_un addr = {.sun_family = AF_UNIX};
|
|
const char name[] = "frametop_relay";
|
|
memcpy(addr.sun_path + 1, name, sizeof name - 1);
|
|
const char *msg = desktop ? "keyboard desktop" : "keyboard steam";
|
|
sendto(s->relay_fd, msg, strlen(msg), MSG_DONTWAIT, (struct sockaddr *)&addr,
|
|
offsetof(struct sockaddr_un, sun_path) + 1 + sizeof name - 1);
|
|
}
|
|
|
|
// How often a screen gets its frame callback (ms; 0 every tick). KWin draws a screen only
|
|
// after its callback, and its apps wait for theirs, so this is the screen's frame rate:
|
|
// full where you look (ft_vr_screen_attention) and for a video, lower for the rest of what
|
|
// you see, and about once a second for what you don't (hidden, behind you, paused for a VR
|
|
// game). A screen nothing changes on costs nothing at any rate: KWin commits only when
|
|
// something on it moved. A remote viewer ("watch") sees every screen at full rate.
|
|
static uint32_t frame_interval(struct server *s, struct screen *sc, uint32_t t) {
|
|
if ((int32_t)(s->watch_until - t) > 0) return 0;
|
|
enum ft_attention a = ft_vr_screen_attention(sc->index);
|
|
if (a == FT_IN_VIEW && (int32_t)(sc->video_until - t) > 0) a = FT_FOCUSED;
|
|
if (a != FT_FOCUSED && t - s->typed_ms < 1500 &&
|
|
s->seat->keyboard_state.focused_surface == sc->toplevel->base->surface)
|
|
a = FT_FOCUSED; // typing on it while looking elsewhere
|
|
const int hz = s->rate[a];
|
|
return hz > 0 ? 1000 / hz : 0;
|
|
}
|
|
|
|
static int64_t mono_ns(void) {
|
|
struct timespec ts;
|
|
clock_gettime(CLOCK_MONOTONIC, &ts);
|
|
return ts.tv_sec * 1000000000LL + ts.tv_nsec;
|
|
}
|
|
|
|
// Ticks come once per display frame, phase_ms after its vsync: KWin gets its frame callbacks
|
|
// early in the frame and has the rest of it to draw before vrcompositor takes the panels.
|
|
// The vsync is read from SteamVR once a second, and the ticks run at absolute times between
|
|
// reads, so they keep their place (a timer set again after each tick, as before, slid
|
|
// through the frame and came about 85 times a second at 90 Hz). Without SteamVR's timing
|
|
// they still come at the display's rate (90 Hz until known). While paused, every 100 ms.
|
|
static void schedule(struct server *s) {
|
|
const int64_t now = mono_ns();
|
|
int64_t next;
|
|
if (ft_vr_paused()) {
|
|
next = now + 100000000LL;
|
|
} else {
|
|
double since, hz;
|
|
if (now - s->synced_ns >= 1000000000LL) {
|
|
s->synced_ns = now;
|
|
if (ft_vr_vsync(&since, &hz)) {
|
|
const int64_t period = (int64_t)(1e9 / hz);
|
|
if (llabs(period - s->period_ns) > 100000) wlr_log(WLR_INFO, "display at %.1f Hz", hz);
|
|
s->period_ns = period;
|
|
s->base_ns = now - (int64_t)(since * 1e9) + (int64_t)(s->phase_ms * 1e6);
|
|
while (s->base_ns > now) s->base_ns -= s->period_ns;
|
|
}
|
|
}
|
|
next = s->base_ns + ((now - s->base_ns) / s->period_ns + 1) * s->period_ns;
|
|
}
|
|
struct itimerspec its = {.it_value = {.tv_sec = next / 1000000000LL, .tv_nsec = next % 1000000000LL}};
|
|
timerfd_settime(s->tick_fd, TFD_TIMER_ABSTIME, &its, NULL);
|
|
}
|
|
|
|
// Each tick: SteamVR events, and frame callbacks for screens that committed and are due.
|
|
static int tick(int fd, uint32_t mask, void *data) {
|
|
struct server *s = data;
|
|
uint64_t expirations;
|
|
const ssize_t got = read(fd, &expirations, sizeof expirations); // clears it; how many doesn't matter
|
|
(void)got;
|
|
ft_vr_poll(handle_vr_event, s);
|
|
if (++s->ticks % 9 == 0) keys_update(s);
|
|
if (s->kb_close_at && s->ticks >= s->kb_close_at) {
|
|
s->kb_close_at = 0;
|
|
if (s->kb_screen >= 0) {
|
|
ft_vr_keyboard_hide();
|
|
s->kb_screen = -1;
|
|
}
|
|
}
|
|
struct timespec now;
|
|
clock_gettime(CLOCK_MONOTONIC, &now);
|
|
const uint32_t t = now_ms();
|
|
// Due within half a tick counts as due, so 15 Hz is every 6th tick at 90 Hz, not 7th.
|
|
const uint32_t slack = ft_vr_paused() ? 50 : (uint32_t)(s->period_ns / 2000000);
|
|
for (int i = 0; i < MAX_SCREENS; ++i) {
|
|
struct screen *sc = s->screens[i];
|
|
if (!sc || !sc->frame_pending || t - sc->frame_sent + slack < frame_interval(s, sc, t)) continue;
|
|
sc->frame_pending = false;
|
|
sc->frame_sent = t;
|
|
wlr_surface_send_frame_done(sc->toplevel->base->surface, &now);
|
|
}
|
|
schedule(s);
|
|
return 0;
|
|
}
|
|
|
|
static int child_exited(int sig, void *data) {
|
|
struct server *s = data;
|
|
int status;
|
|
pid_t pid;
|
|
while ((pid = waitpid(-1, &status, WNOHANG)) > 0)
|
|
if (pid == s->child) {
|
|
wlr_log(WLR_INFO, "session exited");
|
|
wl_display_terminate(s->display);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static bool key_held(const struct wlr_keyboard *kb, uint32_t code) {
|
|
for (size_t i = 0; i < kb->num_keycodes; i++)
|
|
if (kb->keycodes[i] == code) return true;
|
|
return false;
|
|
}
|
|
|
|
// One key to the focused screen, through the seat's keyboard so its xkb state and
|
|
// modifiers stay right.
|
|
static void send_key(struct server *s, uint32_t code, int pressed) {
|
|
s->typed_ms = now_ms();
|
|
struct wlr_keyboard_key_event ev = {
|
|
.time_msec = now_ms(), .keycode = code, .update_state = true,
|
|
.state = pressed ? WL_KEYBOARD_KEY_STATE_PRESSED : WL_KEYBOARD_KEY_STATE_RELEASED};
|
|
wlr_keyboard_notify_key(&s->keyboard, &ev);
|
|
wlr_seat_keyboard_notify_modifiers(s->seat, &s->keyboard.modifiers);
|
|
wlr_seat_keyboard_notify_key(s->seat, ev.time_msec, code, ev.state);
|
|
}
|
|
|
|
// Keys from the input relay (physical keyboards): "key <evdev code> <1 press|0 release>".
|
|
// They go to the screen KWin has keyboard focus on (the last one clicked), while typing
|
|
// goes to the desktop (keys_update). The release of a key the desktop got the press for
|
|
// always goes through, or the key stays held there (a modifier held as typing moves to
|
|
// Steam would otherwise modify every key typed after it).
|
|
static void handle_key(struct server *s, uint32_t code, int value, char *reply, int size) {
|
|
if (value == 2) return (void)snprintf(reply, size, "ok repeat ignored"); // KWin repeats itself
|
|
if (value || !key_held(&s->keyboard, code)) {
|
|
if (!s->seat->keyboard_state.focused_surface) return (void)snprintf(reply, size, "ok no focus");
|
|
if (!s->keys_desktop) return (void)snprintf(reply, size, "ok typing goes to Steam");
|
|
}
|
|
send_key(s, code, value);
|
|
snprintf(reply, size, "ok");
|
|
}
|
|
|
|
// Our keyboard (keyboard.cpp). The input relay sends "vrkeyboard show" when a text field
|
|
// on the desktop gets focus (and its setting allows), "vrkeyboard hide" when it loses it,
|
|
// and "vrkeyboard toggle" for a mapped button; ft-layout sends "vrkeyboard close" when it
|
|
// resets the layout. It opens for the screen KWin has keyboard focus on. A hide closes only a keyboard a text field opened, and waits a moment, so
|
|
// moving between text fields doesn't close and reopen it.
|
|
static int focused_screen(struct server *s) {
|
|
struct wlr_surface *focus = s->seat->keyboard_state.focused_surface;
|
|
for (int i = 0; i < MAX_SCREENS; ++i)
|
|
if (s->screens[i] && s->screens[i]->toplevel->base->surface == focus) return i;
|
|
if (s->pointer_focus) return s->pointer_focus->index;
|
|
for (int i = 0; i < MAX_SCREENS; ++i)
|
|
if (s->screens[i]) return i;
|
|
return -1;
|
|
}
|
|
|
|
static void keyboard_command(struct server *s, const char *what, char *reply, int size) {
|
|
const bool open = s->kb_screen >= 0;
|
|
if (strcmp(what, "hide") == 0) {
|
|
if (open && s->kb_auto && !s->kb_close_at) s->kb_close_at = s->ticks + 30; // ~1/3 s
|
|
return (void)snprintf(reply, size, "ok");
|
|
}
|
|
if (strcmp(what, "close") == 0) { // however it opened, now (ft-layout apply: a reset)
|
|
if (open) wlr_log(WLR_INFO, "keyboard closed (reset)");
|
|
ft_vr_keyboard_hide();
|
|
s->kb_screen = -1;
|
|
s->kb_close_at = 0;
|
|
return (void)snprintf(reply, size, "ok");
|
|
}
|
|
const bool toggle = strcmp(what, "toggle") == 0;
|
|
if (!toggle && strcmp(what, "show") != 0) return (void)snprintf(reply, size, "error show|hide|toggle|close");
|
|
s->kb_close_at = 0;
|
|
if (open && toggle) {
|
|
ft_vr_keyboard_hide();
|
|
s->kb_screen = -1;
|
|
return (void)snprintf(reply, size, "ok closed");
|
|
}
|
|
if (open) return (void)snprintf(reply, size, "ok open");
|
|
if (!ft_vr_screens_shown()) return (void)snprintf(reply, size, "ok screens hidden");
|
|
const int screen = focused_screen(s);
|
|
if (screen < 0 || !ft_vr_keyboard_show(screen)) return (void)snprintf(reply, size, "error not shown");
|
|
wlr_log(WLR_INFO, "keyboard open for screen %d (%s)", screen + 1, toggle ? "button" : "text field");
|
|
s->kb_screen = screen;
|
|
s->kb_auto = !toggle;
|
|
snprintf(reply, size, "ok opened");
|
|
}
|
|
|
|
// A key from our keyboard, for the focused screen. Its release always goes through, so
|
|
// no key stays held.
|
|
static void panel_key(struct server *s, uint32_t code, bool pressed) {
|
|
if (pressed ? s->seat->keyboard_state.focused_surface != NULL : key_held(&s->keyboard, code))
|
|
send_key(s, code, pressed);
|
|
}
|
|
// Control socket: abstract datagram @ft_screens. Here: "size <screen> <w> <h>" (a new
|
|
// resolution, live), "scale <screen> <s>" (KWin's scale for it, from ft-layout),
|
|
// "toplevels" (-> "ok <count>" and a line per KWin window: "<screen> <w>x<h> <commits>
|
|
// <title>"), "input <screen> move|down|up|leave [x y [left|right|middle]]" (pointer input
|
|
// as if from that panel, x and y in its pixels; for tests, mostly with --no-vr),
|
|
// "key <code> <value>", "vrkeyboard show|hide|toggle|close" (our keyboard, from the input
|
|
// relay), and "click <overlay key>" (from the pointer helper: a mouse click landed on
|
|
// that panel, "-" for none); the rest is in vr.cpp (ft_vr_command).
|
|
static int control_readable(int fd, uint32_t mask, void *data) {
|
|
struct server *s = data;
|
|
char buf[512], reply[2048];
|
|
struct sockaddr_un from;
|
|
socklen_t len = sizeof from;
|
|
ssize_t n;
|
|
while ((n = recvfrom(fd, buf, sizeof buf - 1, MSG_DONTWAIT, (struct sockaddr *)&from, &len)) > 0) {
|
|
buf[n] = 0;
|
|
unsigned code;
|
|
int value, index, w, h;
|
|
double scale;
|
|
char tail;
|
|
if (strcmp(buf, "controller-click?") == 0) {
|
|
snprintf(reply, sizeof reply,
|
|
"{\"supported\":true,\"threshold\":%.3f,\"held\":%s,\"dragging\":%s,\"suppressedMotions\":%lu,\"clicks\":%lu,\"drags\":%lu}",
|
|
s->controller_click.threshold, s->controller_click.held ? "true" : "false",
|
|
s->controller_click.dragging ? "true" : "false", s->controller_click.suppressed,
|
|
s->controller_click.clicks, s->controller_click.drags);
|
|
} else if (sscanf(buf, "controller-click %lf %c", &scale, &tail) == 1) {
|
|
if (!isfinite(scale) || scale < 0 || scale > 64 || s->controller_click.buttons)
|
|
snprintf(reply, sizeof reply, "error threshold or held controller button");
|
|
else { s->controller_click.threshold = scale; snprintf(reply, sizeof reply, "ok"); }
|
|
} else if (sscanf(buf, "size %d %d %d", &index, &w, &h) == 3) {
|
|
// A new resolution for a screen, live: KWin resizes the screen to match. (KWin makes
|
|
// it this size times its scale; ft-floatd sends spares' sizes divided by theirs.)
|
|
const int min_w = index - 1 < s->n_config ? 320 : 64, min_h = index - 1 < s->n_config ? 200 : 64;
|
|
if (index < 1 || index > MAX_SCREENS || !s->screens[index - 1] || w < min_w || h < min_h || w > 16384 ||
|
|
h > 16384) {
|
|
snprintf(reply, sizeof reply, "error bad screen or size");
|
|
} else {
|
|
// A screen's size is even: KWin's nested backend gives a scaled screen a whole
|
|
// buffer scale (1.5 -> 2), and a buffer that isn't a multiple of it is a protocol
|
|
// error that disconnects KWin. (ft-floatd rounds spares' sizes for their scale.)
|
|
if (index - 1 < s->n_config) w += w & 1, h += h & 1;
|
|
if (index - 1 < s->n_config) s->config[index - 1].width = w, s->config[index - 1].height = h;
|
|
wlr_xdg_toplevel_set_size(s->screens[index - 1]->toplevel, w, h);
|
|
snprintf(reply, sizeof reply, "ok");
|
|
}
|
|
} else if (sscanf(buf, "scale %d %lf", &index, &scale) == 2) {
|
|
if (index < 1 || index > MAX_SCREENS || !(scale >= 0.25 && scale <= 8)) {
|
|
snprintf(reply, sizeof reply, "error bad screen or scale");
|
|
} else {
|
|
if (s->scale[index - 1] != scale) wlr_log(WLR_INFO, "screen %d: KWin scale %g", index, scale);
|
|
s->scale[index - 1] = scale;
|
|
snprintf(reply, sizeof reply, "ok");
|
|
}
|
|
} else if (sscanf(buf, "key %u %d", &code, &value) == 2) {
|
|
handle_key(s, code, value, reply, sizeof reply);
|
|
len = sizeof from;
|
|
continue; // no reply: keys are fire-and-forget
|
|
} else if (strncmp(buf, "vrkeyboard ", 11) == 0) {
|
|
keyboard_command(s, buf + 11, reply, sizeof reply);
|
|
} else if (strncmp(buf, "input ", 6) == 0) {
|
|
char what[8] = "", button[8] = "left";
|
|
double x = 0, y = 0;
|
|
const int got = sscanf(buf, "input %d %7s %lf %lf %7s", &index, what, &x, &y, button);
|
|
struct ft_event e = {.screen = index - 1, .x = x, .y = y, .button = BTN_LEFT};
|
|
if (strcmp(button, "right") == 0) e.button = BTN_RIGHT;
|
|
else if (strcmp(button, "middle") == 0) e.button = BTN_MIDDLE;
|
|
if (got >= 2 && strcmp(what, "leave") == 0) e.type = FT_LEAVE;
|
|
else if (got >= 4 && strcmp(what, "move") == 0) e.type = FT_MOTION;
|
|
else if (got >= 4 && (strcmp(what, "down") == 0 || strcmp(what, "up") == 0))
|
|
e.type = FT_BUTTON, e.pressed = what[0] == 'd';
|
|
else index = 0;
|
|
if (index < 1 || index > MAX_SCREENS || !s->screens[index - 1]) {
|
|
snprintf(reply, sizeof reply, "error input <screen> move|down|up|leave [x y [button]]");
|
|
} else {
|
|
handle_vr_event(&e, s);
|
|
snprintf(reply, sizeof reply, "ok");
|
|
}
|
|
} else if (sscanf(buf, "watch %d", &value) == 1) {
|
|
// A remote viewer is watching for that many seconds (vnc-bridge.sh renews it).
|
|
s->watch_until = now_ms() + (uint32_t)(value < 0 ? 0 : value > 60 ? 60 : value) * 1000;
|
|
snprintf(reply, sizeof reply, "ok");
|
|
} else if (sscanf(buf, "rates %d %d %d", &index, &w, &h) == 3) {
|
|
// Frame rates in Hz: focused, in view, hidden (0: every display frame).
|
|
if (index < 0 || w < 0 || h < 0 || index > 240 || w > 240 || h > 240) {
|
|
snprintf(reply, sizeof reply, "error rates <focused> <in view> <hidden> (Hz, 0 full)");
|
|
} else {
|
|
s->rate[FT_FOCUSED] = index, s->rate[FT_IN_VIEW] = w, s->rate[FT_HIDDEN] = h;
|
|
wlr_log(WLR_INFO, "frame rates: focused %d, in view %d, hidden %d (0 full)", index, w, h);
|
|
snprintf(reply, sizeof reply, "ok");
|
|
}
|
|
} else if (sscanf(buf, "phase %lf", &scale) == 1) {
|
|
// Ticks this long after the vsync (ms), for tuning.
|
|
if (!(scale >= 0 && scale < 20)) snprintf(reply, sizeof reply, "error phase <ms after vsync>");
|
|
else s->phase_ms = scale, s->synced_ns = 0, snprintf(reply, sizeof reply, "ok");
|
|
} else if (strcmp(buf, "rates?") == 0) {
|
|
// "ok <focused> <in view> <hidden> <display Hz> <phase ms> <watched>" and a line per
|
|
// screen: "<screen> hidden|view|focused <ms between frames> <video 0|1>".
|
|
static const char *names[] = {"hidden", "view", "focused"};
|
|
const uint32_t t = now_ms();
|
|
int at = snprintf(reply, sizeof reply, "ok %d %d %d %.1f %.1f %d", s->rate[FT_FOCUSED],
|
|
s->rate[FT_IN_VIEW], s->rate[FT_HIDDEN], 1e9 / s->period_ns, s->phase_ms,
|
|
(int32_t)(s->watch_until - t) > 0);
|
|
for (int i = 0; i < MAX_SCREENS && at < (int)sizeof reply; ++i) {
|
|
struct screen *sc = s->screens[i];
|
|
if (!sc) continue;
|
|
at += snprintf(reply + at, sizeof reply - at, "\n%d %s %u %d", i + 1,
|
|
names[ft_vr_screen_attention(i)], frame_interval(s, sc, t),
|
|
(int32_t)(sc->video_until - t) > 0);
|
|
}
|
|
} else if (strcmp(buf, "toplevels") == 0) {
|
|
int n = 0, at = 0;
|
|
for (int i = 0; i < MAX_SCREENS; ++i) n += s->screens[i] != NULL;
|
|
at = snprintf(reply, sizeof reply, "ok %d", n);
|
|
for (int i = 0; i < MAX_SCREENS && at < (int)sizeof reply; ++i) {
|
|
const struct screen *sc = s->screens[i];
|
|
if (!sc) continue;
|
|
at += snprintf(reply + at, sizeof reply - at, "\n%d %dx%d %u %s", i + 1, sc->buffer_width,
|
|
sc->buffer_height, sc->commits, sc->toplevel->title ? sc->toplevel->title : "");
|
|
}
|
|
} else if (strncmp(buf, "click ", 6) == 0) {
|
|
// A click on another panel takes typing to Steam. Our own panels (the screens,
|
|
// their controls) leave it: a click on a screen arrives as a panel event.
|
|
if (strcmp(buf + 6, "-") != 0 && strncmp(buf + 6, "frametop.", 9) != 0) s->keys_clicked = false;
|
|
len = sizeof from;
|
|
continue;
|
|
} else {
|
|
ft_vr_command(buf, reply, sizeof reply);
|
|
}
|
|
if (len > offsetof(struct sockaddr_un, sun_path))
|
|
sendto(fd, reply, strlen(reply), MSG_DONTWAIT, (struct sockaddr *)&from, len);
|
|
len = sizeof from;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static int open_control_socket(const char *name) {
|
|
int fd = socket(AF_UNIX, SOCK_DGRAM | SOCK_CLOEXEC | SOCK_NONBLOCK, 0);
|
|
struct sockaddr_un addr = {.sun_family = AF_UNIX};
|
|
const size_t len = strlen(name);
|
|
if (len == 0 || len >= sizeof addr.sun_path - 1) {
|
|
wlr_log(WLR_ERROR, "bad control socket name");
|
|
close(fd);
|
|
return -1;
|
|
}
|
|
memcpy(addr.sun_path + 1, name, len);
|
|
if (bind(fd, (struct sockaddr *)&addr, offsetof(struct sockaddr_un, sun_path) + 1 + len) != 0) {
|
|
wlr_log(WLR_ERROR, "can't bind @%s (another ft-screens running?)", name);
|
|
close(fd);
|
|
return -1;
|
|
}
|
|
return fd;
|
|
}
|
|
|
|
static int stop(int sig, void *data) {
|
|
wl_display_terminate(((struct server *)data)->display);
|
|
return 0;
|
|
}
|
|
|
|
// ---------------------------------------------------------------- setup
|
|
|
|
static void keyboard_led(struct wlr_keyboard *kb, uint32_t leds) {}
|
|
static const struct wlr_keyboard_impl keyboard_impl = {.name = "ft-screens-keyboard", .led_update = keyboard_led};
|
|
|
|
static bool setup_dmabuf(struct server *s) {
|
|
struct stat st;
|
|
const char *node = "/dev/dri/renderD128";
|
|
if (stat(node, &st) != 0) {
|
|
wlr_log(WLR_ERROR, "no %s", node);
|
|
return false;
|
|
}
|
|
struct wlr_linux_dmabuf_feedback_v1 fb = {.main_device = st.st_rdev};
|
|
wl_array_init(&fb.tranches);
|
|
struct wlr_linux_dmabuf_feedback_v1_tranche *tr = wlr_linux_dmabuf_feedback_add_tranche(&fb);
|
|
tr->target_device = st.st_rdev;
|
|
const uint32_t formats[] = {DRM_FORMAT_XRGB8888, DRM_FORMAT_ARGB8888};
|
|
for (size_t f = 0; f < 2; ++f) {
|
|
uint64_t mods[64];
|
|
const int n = ft_vr_modifiers(formats[f], mods, 64);
|
|
for (int i = 0; i < n; ++i) wlr_drm_format_set_add(&tr->formats, formats[f], mods[i]);
|
|
wlr_log(WLR_INFO, "dmabuf: format 0x%x, %d modifiers SteamVR can import", formats[f], n);
|
|
}
|
|
struct wlr_linux_dmabuf_v1 *dmabuf = wlr_linux_dmabuf_v1_create(s->display, 4, &fb);
|
|
wlr_linux_dmabuf_feedback_v1_finish(&fb);
|
|
return dmabuf != NULL;
|
|
}
|
|
|
|
int main(int argc, char **argv) {
|
|
struct server s = {0};
|
|
// About 0.9 degrees on a 3.4 m wide 3440-pixel screen 2 m away; 8 (the first default,
|
|
// about 0.2 degrees) needed a very still hand to click (headset test 2026-10-03).
|
|
s.controller_click.threshold = 32;
|
|
for (int i = 0; i < MAX_SCREENS; ++i) s.scale[i] = 1;
|
|
s.kb_screen = -1;
|
|
s.rate[FT_FOCUSED] = 0, s.rate[FT_IN_VIEW] = 15, s.rate[FT_HIDDEN] = 1;
|
|
s.period_ns = 1000000000LL / 90;
|
|
s.phase_ms = 1;
|
|
const char *socket_name = "ft-screens-0", *control_name = "ft_screens";
|
|
char **command = NULL;
|
|
s.vr = true;
|
|
for (int i = 1; i < argc; ++i) {
|
|
if (strcmp(argv[i], "--socket") == 0 && i + 1 < argc) {
|
|
socket_name = argv[++i];
|
|
} else if (strcmp(argv[i], "--control") == 0 && i + 1 < argc) {
|
|
control_name = argv[++i];
|
|
} else if (strcmp(argv[i], "--spares") == 0 && i + 1 < argc) {
|
|
s.spares = atoi(argv[++i]);
|
|
} else if (strcmp(argv[i], "--no-vr") == 0) {
|
|
s.vr = false;
|
|
} else if (strcmp(argv[i], "--rates") == 0 && i + 1 < argc) {
|
|
if (sscanf(argv[++i], "%d,%d,%d", &s.rate[FT_FOCUSED], &s.rate[FT_IN_VIEW], &s.rate[FT_HIDDEN]) != 3) {
|
|
fprintf(stderr, "bad --rates %s (want FOCUSED,IN_VIEW,HIDDEN in Hz, 0 full)\n", argv[i]);
|
|
return 2;
|
|
}
|
|
} else if (strcmp(argv[i], "--screen") == 0 && i + 1 < argc && s.n_config < MAX_SCREENS) {
|
|
struct config *c = &s.config[s.n_config];
|
|
c->metres = 0;
|
|
if (sscanf(argv[++i], "%dx%d@%lf", &c->width, &c->height, &c->metres) < 2) {
|
|
fprintf(stderr, "bad --screen %s (want WxH@METRES)\n", argv[i]);
|
|
return 2;
|
|
}
|
|
if (c->metres <= 0) c->metres = 1.5 * c->width / 1920.0;
|
|
++s.n_config;
|
|
} else if (strcmp(argv[i], "--") == 0) {
|
|
command = &argv[i + 1];
|
|
break;
|
|
} else {
|
|
fprintf(stderr,
|
|
"usage: %s [--socket NAME] [--control NAME] [--no-vr] [--screen WxH@METRES]... "
|
|
"[--spares N] [--rates F,V,H] [-- COMMAND ARGS...]\n",
|
|
argv[0]);
|
|
return 2;
|
|
}
|
|
}
|
|
if (s.n_config == 0) s.config[s.n_config++] = (struct config){3440, 1440, 2.4};
|
|
|
|
setvbuf(stdout, NULL, _IOLBF, 0); // vr.cpp prints to stdout; keep it in order with the log
|
|
wlr_log_init(WLR_INFO, NULL);
|
|
if (s.vr && !ft_vr_init()) return 1;
|
|
if (!s.vr) wlr_log(WLR_INFO, "--no-vr: running without SteamVR");
|
|
|
|
s.display = wl_display_create();
|
|
s.loop = wl_display_get_event_loop(s.display);
|
|
wl_list_init(&s.buffers);
|
|
wlr_compositor_create(s.display, 6, NULL);
|
|
wlr_subcompositor_create(s.display);
|
|
const uint32_t shm_formats[] = {DRM_FORMAT_ARGB8888, DRM_FORMAT_XRGB8888}; // wlroots wants DRM codes
|
|
wlr_shm_create(s.display, 1, shm_formats, 2);
|
|
if (!setup_dmabuf(&s)) return 1;
|
|
wlr_data_device_manager_create(s.display);
|
|
|
|
s.xdg_shell = wlr_xdg_shell_create(s.display, 3);
|
|
s.new_toplevel.notify = new_toplevel;
|
|
wl_signal_add(&s.xdg_shell->events.new_toplevel, &s.new_toplevel);
|
|
s.decoration = wlr_xdg_decoration_manager_v1_create(s.display);
|
|
s.new_decoration.notify = new_decoration;
|
|
wl_signal_add(&s.decoration->events.new_toplevel_decoration, &s.new_decoration);
|
|
|
|
s.seat = wlr_seat_create(s.display, "seat0");
|
|
wlr_keyboard_init(&s.keyboard, &keyboard_impl, "ft-screens-keyboard");
|
|
struct xkb_context *xkb = xkb_context_new(XKB_CONTEXT_NO_FLAGS);
|
|
struct xkb_keymap *keymap = xkb_keymap_new_from_names(xkb, NULL, XKB_KEYMAP_COMPILE_NO_FLAGS);
|
|
wlr_keyboard_set_keymap(&s.keyboard, keymap);
|
|
xkb_keymap_unref(keymap);
|
|
xkb_context_unref(xkb);
|
|
wlr_seat_set_keyboard(s.seat, &s.keyboard);
|
|
wlr_seat_set_capabilities(s.seat, WL_SEAT_CAPABILITY_POINTER | WL_SEAT_CAPABILITY_KEYBOARD);
|
|
|
|
if (wl_display_add_socket(s.display, socket_name) != 0) {
|
|
wlr_log(WLR_ERROR, "can't create socket %s (another ft-screens?)", socket_name);
|
|
return 1;
|
|
}
|
|
char path[256];
|
|
snprintf(path, sizeof path, "%s/%s", getenv("XDG_RUNTIME_DIR") ? getenv("XDG_RUNTIME_DIR") : "/tmp", socket_name);
|
|
wlr_log(WLR_INFO, "listening on %s; %d screen(s) configured, %d spare(s)", path, s.n_config, s.spares);
|
|
|
|
const int control = open_control_socket(control_name);
|
|
if (control < 0) return 1;
|
|
s.relay_fd = socket(AF_UNIX, SOCK_DGRAM | SOCK_CLOEXEC | SOCK_NONBLOCK, 0);
|
|
wl_event_loop_add_fd(s.loop, control, WL_EVENT_READABLE, control_readable, &s);
|
|
|
|
s.tick_fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK | TFD_CLOEXEC);
|
|
s.base_ns = mono_ns();
|
|
s.tick = wl_event_loop_add_fd(s.loop, s.tick_fd, WL_EVENT_READABLE, tick, &s);
|
|
schedule(&s);
|
|
wl_event_loop_add_signal(s.loop, SIGINT, stop, &s);
|
|
wl_event_loop_add_signal(s.loop, SIGTERM, stop, &s);
|
|
wl_event_loop_add_signal(s.loop, SIGCHLD, child_exited, &s);
|
|
|
|
if (command && command[0]) {
|
|
s.child = fork();
|
|
if (s.child == 0) {
|
|
setenv("WAYLAND_DISPLAY", path, 1);
|
|
execvp(command[0], command);
|
|
perror(command[0]);
|
|
_exit(127);
|
|
}
|
|
}
|
|
|
|
// Ahead of the desktop's programs for the CPU, after the session started (it would
|
|
// inherit it): KWin waits for our ticks to draw. SteamOS lets users go to nice -8
|
|
// (RLIMIT_NICE 28) once they raise their soft limit; without that, as before.
|
|
if (s.vr) {
|
|
struct rlimit rl;
|
|
if (getrlimit(RLIMIT_NICE, &rl) == 0 && rl.rlim_cur < rl.rlim_max) {
|
|
rl.rlim_cur = rl.rlim_max;
|
|
setrlimit(RLIMIT_NICE, &rl);
|
|
}
|
|
if (setpriority(PRIO_PROCESS, 0, -5) != 0) wlr_log(WLR_INFO, "can't raise our priority (nice -5); running at 0");
|
|
}
|
|
|
|
wl_display_run(s.display);
|
|
|
|
wlr_log(WLR_INFO, "stopping");
|
|
if (s.child > 0) kill(s.child, SIGTERM);
|
|
wl_display_destroy_clients(s.display);
|
|
// wlroots asserts that nothing still listens to its globals when they go.
|
|
wl_list_remove(&s.new_toplevel.link);
|
|
wl_list_remove(&s.new_decoration.link);
|
|
ft_vr_shutdown();
|
|
wl_display_destroy(s.display);
|
|
return 0;
|
|
}
|