steam-frame/DeeJanuz--frametop
1
0 Fork 0
mirror of https://github.com/DeeJanuz/frametop.git synced 2026-10-06 01:00:06 +02:00
Code Issues Packages Projects Releases 3 Wiki Activity

3 Releases 4 Tags

RSS Feed
  • v0.1.1 14879023f3
    Compare

    Frametop 0.1.1 Stable

    DieMitchell released this 2026-10-04 07:34:04 +02:00 | 244 commits to main since this release

    Frametop 0.1.1 fixes typing and the volume keys, lines the desktop up with the screens around you, and adds mapping for the Frame controllers' buttons. It also brings two experimental pointer modes, head follow and gaze, which are off by default.

    Changes

    • Typing follows your last click. A keyboard used to type into the desktop and into the Steam app with focus at the same time, so a space typed on the desktop could pause music playing on the dashboard. Now keys go only to what you clicked last, the screens or a Steam panel.
    • The volume keys can't end the VR session. A volume press with nothing focused could crash gamescope. Frametop now handles the volume keys of the headset and of keyboards itself, in 5% steps on the default output.
    • Keys don't stick when the dashboard opens. A key held as the SteamVR dashboard opens is now released on the desktop too.
    • The desktop is arranged like the screens. KWin's outputs follow where the screens sit around you, so the mouse pointer and dragged windows cross to the screen you see next to the one you're on.
    • Frame controller buttons. Frametop Input Settings has a new Controllers page for mapping the Frame controllers' buttons to actions. It also has a Global input switch for the SteamVR setting that mapped buttons need.
    • The 3D mouse reaches all of SteamVR's Settings page. It used to miss most of that page. On that page only, it now shows a laser beam and a larger hit dot.
    • A screen's controls show when a laser lands on them, and they stay with the screen when the layout moves it.
    • Controller rays aim along the laser instead of along the controller.
    • A mouse or keyboard that reconnects between device scans is picked up.
    • The Meta tap shortcut for the dashboard is off by default.
    • Installer fixes: the desktop starts without the Steam client's environment, the build container setup works on the headset, and reinstalling leaves an unchanged SteamVR driver in place.

    Experimental, off by default

    • Head follow. The pointer comes along when you turn your head. Turn it on with POINTER_FOLLOW=1, or map a mouse button to Head follow on/off. It's only lightly tested.
    • Gaze. The pointer goes where you look, and the mouse does the last bit. It uses the Frame's eye tracking. It isn't installed with the rest of Frametop; see gaze/README.md to set it up.

    docs/hazards.md lists the ways the input changes could go wrong and what to check. Tools that watch every keyboard for a hotkey stop seeing a keyboard while it types into the desktop. SHARE_KEYS=1 passes its keys on to them. This is off by default, because any local program could read those keys.

    Update

    cd ~/frametop && git pull && ./install.sh

    Tested on one Steam Frame (SteamOS 0.3.0 build 20260922, SteamVR 2.17.10). See the known limitations. If something goes wrong, run scripts/report.sh and open an issue.

    Downloads