This repository contains is a simplified Rust SDK for the following glasses:

• XREAL Air
• XREAL Light
• Rokid Air
• Rokid Max (Only display mode switching, no IMU data)
• Mad Gaze Glow

It supports getting basic sensor data and setting up the display.

While only the these glasses is supported right now, if I could get my hands on some other ones, I'd happily support them too.

There's a somewhat detailed blog post documenting the various protocols too. So if you're only interested in that, you won't even need to read Rust code :)

Some people only need programmatic mode switching. For that, all you need to do is:

Install dependencies (rust and libudev)

sudo apt install cargo libudev-dev
cargo update

Optional: add the udev scripts to your udev config, so the glasses are available to regular users:

sudo cp udev/* /etc/udev/rules.d/
sudo udevadm control --reload

Run the code directly:

cargo run --example set_to_3d

Or build and then run:

cargo build --release --example set_to_3d
target/release/examples/set_to_3d

The executable is statically linked so you can copy it around, even to other PCs.

I appreciate reported bugs, feature requests and of course pull request.

Licensed under the MIT license

Some parts of the protocols were obtained with reverse engineering.

Reverse engineering explicitly allowed in the EU for interworking purposes. It's probably fair use everywhere else, but you should check your own country's laws.

The project is not affiliated with XREAL, Mad Gaze, Rokid, or any other related entities.