Skip to content

Hovera 0.2.0

Latest

Choose a tag to compare

@MegaBadCoder MegaBadCoder released this 07 Oct 17:06
· 0 commits to main since this release

Hovera 0.2.0. The monitors are now pinned to the room with the MacBook camera: the app learns the shape of your glasses and tracks it, while the gyro keeps the picture glued to your head.

What's new since 0.1.0

  • Glasses tracking in the camera: a MediaPipe face model in CoreML, the shape of your glasses learned once and tracked afterwards — screens stop sliding as the gyro drifts.
  • The heading is corrected against the camera while the face is visible; past a 30° head turn the picture hands over to the gyro without a jump, so side monitors stop snapping when the face is lost.
  • Compass: the world turns no faster than 0.5°/s, so turning in your chair next to something magnetic no longer throws the screens 18° aside; K refines the compass centre by the glasses' orientation.
  • The RayNeo firmware silently re-zeroes its gyro and can eat a slow head turn; those re-zeroes are now undone (Camera → "Отменять пересчёты нуля гироскопа прошивкой", on by default). Give it a minute after switching: the gyro zero is re-learned.
  • Gyro scale calibration with two full turns of the glasses on the desk (menu → "Калибровка масштаба гироскопа (очки на столе)"). On the author's pair the gyro under-counted by 3.3 %.
  • Recentring: R puts the screens back by the MacBook frame (first press shows the outline and a crosshair, second press aligns them); B remembers the Mac screen; M marks "I am looking at the middle screen" in the log.
  • Sharper text in the glasses: 1920×1080 without HiDPI and a bicubic Catmull-Rom rescale instead of trilinear.
  • Guided camera calibration (⇧K) and a debug window with the live picture, the face box and landmarks.
  • Head position reworked: the face is measured on its rigid upper part, with depth smoothing and dead zones — the picture no longer pulsates.

Install

  1. Download Hovera-0.2.0-macOS-arm64.zip, unzip, move RayDesk.app to Applications.
  2. The build is not notarized: open it once, then System Settings → Privacy & Security → "Open Anyway" (or xattr -dr com.apple.quarantine /Applications/RayDesk.app).
  3. Allow Screen Recording and Accessibility when asked.
  4. Put on the glasses, look at a distant point and press ⌃⌥R. Calibrate the compass with ⌃⌥K.

Requirements

  • macOS 15 or later, Apple Silicon.
  • RayNeo Air-series glasses (USB 1bbb:af50). Tested on one pair so far — reports from other models are welcome in Issues.

Unofficial project, not affiliated with RayNeo or TCL. The app is still called RayDesk inside.

SHA-256: 82eacb82cbf03ea4111985df7c87f39bbf25159be1918652a11966c849897427