Skip to content
Public template

About

The start of a new headset for overpressure: run scripts/new-headset.py once, then follow docs/adding-a-headset.md

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

My Headset

Newest release CI on main Chat: the My Headset room on Matrix

Linux and Valve's SteamVR on My Headset, installed with overpressure. It replaces the headset's stock system with a system built on Valve's Steam Frame software: SteamVR, the Steam client and its games run on the headset itself, without a PC. The way back to the stock system is part of it.

Status In development: nothing to install yet
Newest release none yet
Your headset My Headset; the stock system versions it needs follow with the first release
Your computer Windows ❔ · Linux ❔ · macOS ❔
Tested on no headset yet

Warning

Installing will erase the stock system's apps and data. The installer makes a full backup first: it is your way back, so keep it safe.

What works

✅ Works · 🟡 Works, with limits · ❌ Doesn't work yet · ❔ Not tested yet · ➖ Not on this headset

Display and comfort

Feature Notes
Both displays ❔
Lens distance (IPD) ❔
Standby when taken off ❔
Cooling ❔

Tracking

Feature Notes
Head tracking (6DoF) ❔
Controller tracking ❔
Hand tracking ❔
Eye tracking ❔
Room setup and boundary ❔
Passthrough (room view) ❔

Controllers

Feature Notes
Buttons, sticks and triggers ❔
Vibration ❔
Battery level ❔
Pairing ❔

Sound

Feature Notes
Speakers and volume ❔
Microphone ❔
Headphone jack ❔

Connections and power

Feature Notes
Wi-Fi ❔
Bluetooth ❔
Battery and charging ❔
Sleep ❔
Battery life ❔

Games and apps

Feature Notes
Steam store and library ❔
Linux games ❔
Windows games (Proton) ❔
Android apps ❔
PC VR over Steam Link ❔
Video playback ❔

Installing

Feature Notes
Install ❔
Upgrade to a new release ❔
Back to the stock system ❔

Everything that is still open: the issues.

What you need

  • My Headset, charged.
  • A USB-C cable that carries data, not only power.
  • A computer with Windows, Linux or macOS and an internet connection.

Install

There is no release to install yet. Once there is:

  1. Download overpressure and unpack it.
  2. Start it: double-click Install.cmd on Windows or Install.command on macOS, or run sh install.sh on Linux.
  3. Accept the disclaimer, choose My Headset and click Download.
  4. Click Install and follow the window. It checks your computer and the headset, backs the headset up, then installs.
  5. When the window says so, unplug the headset and put it on.

Upgrade installs a newer release and keeps your data. Restore to stock brings the stock system back from the backup.

If something goes wrong

The window says what state the headset is in and what to do next; starting it again goes on where it stopped. To report a problem, click Save logs… on My Headset's page in the window and attach the file to an issue; it leaves out your headset's serial numbers.

Questions and quick help: the My Headset room and the Help room of the project's Matrix space.

For developers

How it works, how it is built and how it is tested: docs/, starting with CLAUDE.md and docs/releasing.md.

About

The start of a new headset for overpressure: run scripts/new-headset.py once, then follow docs/adding-a-headset.md

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages