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

3 Releases 3 Tags

RSS Feed
  • v0.2.0 8b854fd424
    Compare

    Frametop 0.2.0 Stable

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

    Frametop 0.2.0 lets app windows float on their own, adds profiles that bring back your screens and apps, and installs with one command. It also offers gaze mode at install, with its calibration in the headset, and can turn the displays off when the headset isn't used.

    New

    • Floating windows. Any desktop window can float in VR as a panel of its own: press Meta+Shift+F, click the float button in its title bar, or pick Launch as Standalone in an app's right-click menu. The window stays part of the desktop, so drag and drop, the clipboard, the taskbar, and Alt+Tab keep working. Meta+scroll scales it, and an app floats where it floated last.
    • Profiles. A profile saves where the screens are, which ones show, and which apps are open where. Opening one moves the screens, puts open windows in place, and starts the apps that aren't open. Nothing closes. The desktop can start in a profile, each profile has a launcher entry, and a profile can go on a key or a button.
    • Hide screens one at a time (Frametop Display Settings, Visibility & pins). New windows that would open on a hidden screen float instead.
    • Pin a screen to your head, like a HUD.
    • Displays off when the headset isn't used, even on a stand that covers its proximity sensor, and the headset stays awake on the charger (Frametop Display Settings, Power).
    • Frametop Remote Access, an app that turns the VNC view on and off and shows or changes its password. The VNC view shows the primary screen.
    • A keyboard for text fields. Frametop's on-screen keyboard opens when you select a text field and no keyboard is connected (Frametop Input Settings, Keyboard).
    • Ignored panels. The pointer passes through panels you pick, such as a performance overlay that follows your view.
    • One-line install and update: curl -fsSL https://deejanuz.github.io/frametop/get.sh | bash. It asks for stable or experimental, and running it again updates.
    • scripts/doctor.sh checks what Frametop needs from SteamOS after an update.

    Gaze mode (experimental)

    The installer now offers it, and it stays off until you turn it on on the Gaze page of Frametop Input Settings.

    • Meta+J and Meta+K click where you look. Hold one and turn your head to correct the aim; held still, it drags.
    • By default the mouse only corrects. Its buttons work like Meta+J and Meta+K. A double right click, or a double Meta+K, pans and tilts what you're dragging.
    • Calibration runs in a panel fixed to the headset. A quick check runs when you put the headset on, Calibrate asks you to click on each dot, and Check headset fit shows how well the tracker sees your eyes.
    • Each correction teaches the tracker, up to 55 degrees. A bigger correction starts a quick check.
    • Our own eye tracker can replace SteamVR's (installed separately; see gaze/README.md).
    • Gaze clicks on the Frame controllers were tried and dropped (why).

    Fixes

    • Keys the desktop holds that no keyboard holds are released within about a second. A stuck Meta key used to make typing open the overview.
    • Frametop's SteamVR clients start only once SteamVR is up (#6, thanks @utrack).
    • The input relay survives a malformed control message, a rows setting that the screens can't fill gets a working layout, and the volume keys try every key when one swap fails (from #8, thanks @0x1f6).
    • Clicks land where the cursor is on scaled desktop screens.
    • Resting controllers no longer take the laser from the mouse.
    • Flatpak apps can save and upload files in the desktop.
    • Frametop Input Settings warns when SteamVR hasn't loaded the pointer driver.
    • Installer: the Bluetooth fixes' password prompt works during the install, services that need SteamVR wait for it, and the uninstall removes everything Frametop put in place.

    Not in this release

    Hand tracking (hands shown over the screens, pinch to click) is in the repo but deferred: it uses a lot of the headset's CPU and needs more work. The installer doesn't offer it.

    Update

    curl -fsSL https://deejanuz.github.io/frametop/get.sh | bash

    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