VR/XR using XREAL Air

KERNEL=="hidraw*", ATTRS{idVendor}=="3318", ATTRS{idProduct}=="0424", MODE="0666", TAG+="uaccess", ENV{ID_INPUT}="", ENV{ID_INPUT_JOYSTICK}="", ENV{ID_INPUT_TABLET}=""

SUBSYSTEM=="usb", ATTRS{idVendor}=="3318", ATTRS{idProduct}=="0424", MODE="0666", TAG+="uaccess"

$ sudo udevadm control --reload-rules && sudo udevadm trigger

[OPTION 視点追従の遅延やカクつきが特に気になる場合] リアルタイムスレッド権限の付与

$ sudo vi /etc/security/limits.d/99-realtime.conf

@realtime - rtprio 99

@realtime - memlock unlimited

$ sudo groupadd realtime

$ sudo usermod -aG realtime $USER

-> logout -> login

monado-service の起動

$ rm -f /run/user/1000/monado_comp_ipc

$ export XRT_COMPOSITOR_WINDOW_BACKEND=xlib # X11互換モードでのウィンドウ描画を強制する

$ export XRT_COMPOSITOR_FORCE_WINDOW=1

$ export XRT_DEVICE_PRIMARY=xreal_air # XREAL Airドライバを最優先にする

$ monado-service # 起動 (ログに「0: Xreal Air Glasses」と出れば成功。この端末は開いたままにする)

ParaView 起動

$ export XR_RUNTIME_JSON=/usr/local/share/openxr/1/openxr_monado.json # Monado のパスを登録

$ paraview

Tools->Plugin で XRInterface を load

- 下側に表示：カメラ位置変更、または物体移動で対応

注意：

[2026-08-18] Ubuntu 24.04 の apt でインストールできる Monado (libopenxr1-monado)は XREAL Air ドライバーが入っていないため，動作しません．
[2026-08-18] git でインストールできる最新バージョンは segmentation fault を起こしてしまいます．
GPU 無しでも表示可能ですが，重いと落ちる(黒画面)可能性があります．

openxr-utils で動作テスト

(2026-08-18)

openxr-utils のインストール

$ sudo apt install libopenxr-utils

動作状況確認

$ openxr_runtime_list

createInfo->applicationInfo.applicationName: List

createInfo->applicationInfo.applicationVersion: 1

createInfo->applicationInfo.engineName: List Engine

createInfo->applicationInfo.engineVersion: 1

createInfo->applicationInfo.apiVersion: 1.0.20

appinfo.detected.engine.name: (null)

appinfo.detected.engine.version: 0.0.0

quirks.disable_vulkan_format_depth_stencil: false

quirks.no_validation_error_in_create_ref_space: true

Head: 'Xreal Air Glasses'

Eyes: '<none>'

Left: '<none>'

Right: '<none>'

Gamepad: '<none>'

Hand-Tracking Left: '<none>'

Hand-Tracking Right: '<none>'

Evaluating system

name: 'Monado: Xreal Air Glasses'

vendorId: 0x2a

systemId: 0x1

systemName: Monado: Xreal Air Glasses

List instance extensions

XR_KHR_binding_modification 1

XR_KHR_composition_layer_cylinder 4

XR_KHR_composition_layer_depth 6

XR_KHR_composition_layer_equirect2 1

XR_KHR_convert_timespec_time 1

XR_KHR_locate_spaces 1

XR_KHR_maintenance1 1

XR_KHR_opengl_enable 10

XR_KHR_opengl_es_enable 8

XR_KHR_swapchain_usage_input_attachment_bit 3

XR_KHR_visibility_mask 2

XR_KHR_vulkan_enable 8

XR_KHR_vulkan_enable2 2

XR_KHR_vulkan_swapchain_format_list 4

XR_EXT_dpad_binding 1

XR_EXT_eye_gaze_interaction 2

XR_EXT_hand_interaction 1

XR_EXT_hand_tracking 4

XR_EXT_hp_mixed_reality_controller 1

XR_EXT_local_floor 1

XR_EXT_samsung_odyssey_controller 1

XR_BD_controller_interaction 2

XR_FB_composition_layer_image_layout 1

XR_FB_display_refresh_rate 1

XR_FB_touch_controller_pro 1

XR_FB_touch_controller_proximity 1

XR_META_touch_controller_plus 1

XR_ML_ml2_controller_interaction 1

XR_MND_headless 2

XR_MND_swapchain_usage_input_attachment_bit 2

XR_MSFT_unbounded_reference_space 1

XR_OPPO_controller_interaction 1

XR_EXTX_overlay 5

XR_HTC_vive_cosmos_controller_interaction 1

XR_HTC_vive_focus3_controller_interaction 2

XR_MNDX_ball_on_a_stick_controller 1

XR_MNDX_egl_enable 2

XR_MNDX_force_feedback_curl 1

XR_MNDX_hydra 1

XR_MNDX_system_buttons 1

XR_MNDX_xdev_space 1

XR_EXT_debug_utils 4

List API layer properties

Multiple graphics APIs の動作テスト (なぜかメイン画面へ表示されるので、マウスで移動して確認

$ hello_xr -g Vulkan

$ sudo apt install libgl1-mesa-dev libglu1-mesa-dev

$ hello_xr -g OpenGL

参考：aptでのインストール [動作せず]

[2026-08-18] Ubuntu 24.04 の apt でインストールできる Monado (libopenxr1-monado)は XREAL Air ドライバーが入っていないため，動作しません．

Install by apt

$ sudo apt update

$ sudo apt install libopenxr-loader1 libopenxr-dev libopenxr1-monado

$ sudo apt install xr-hardware

$ sudo vi /etc/udev/rules.d/60-xreal-air.rules

# XREAL Air / Air 2

KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="2821", MODE="0666", GROUP="plugdev"

$ sudo udevadm control --reload-rules && sudo udevadm trigger

X11(Xorg)でログイン
1. XREAL Air は 3840×1080 (Side-by-Side で表示)
2. openxr-utils で動作テスト

$ sudo apt install libopenxr-utils

1. - 動作状況確認

$ openxr_runtime_list

1. - Multiple graphics APIs の動作テスト (XREAL Air へサンプル表示)

$ hello_xr -g Vulkan

$ sudo apt install libgl1-mesa-dev libglu1-mesa-dev

$ hello_xr -g OpenGL

1. ParaView 起動

$ export XR_RUNTIME_JSON=/usr/share/openxr/1/openxr_monado.json

$ paraview

Tools->Plugin で XRInterface を load

Ubuntu22.04

(2023-10-08)

SteamVR

Install:

Install Steam
1. Ubuntu Software : Steam installer
2. Steam 起動
  1. Install steamVR
Install OpenVR-xrealAirGlassesHMD
1. SteamVR へドライバーの登録
  1. $ ~/.steam/steam/steamapps/common/SteamVR/bin/vrpathreg.sh adddriver ~/air_glasses
2. udev ルールの登録
  1. $ sudo cp ./air_glassesudev/60-xreal-air.rules /etc/udev/rules.d/
  2. $ udevadm control --reload
Install KDE-desktop
1. sudo apt install kde-plasma-desktop

起動：

ログオフし，右下の鍵マークから plasma を選択してログイン
XREAL Air を PC に USB-c で接続
1. 輝度+ を長押しで 3840x1080 (3D mode : Side by Side) へ変更
SteamVR 起動：Steam -> SteamVR
1. SteamVR setup
  1. xreal air のブロックを解除
2. Room setup

Test env. : Lenovo ThinkPad X390

注意：

GNOME Wayland (ubuntu デフォルト window manager) では SteamVR が動かない -> KDE-desktop のインストールが必要
- "Your desktop environment (GNOME Wayland) does not support Direct Rendering Manager"
- Linux版SteamVRのサポート
Controller の利用方法は調査中
ParaView : Ubuntu 版で XRInterface plugin をコンパイルする必要ありと思われるが．．．
- [2025-11-16] ParaView 6.0.1 - ubuntu 24.04 では XRInterface plugin が入っているが、使い方が不明 (libopenxr-dev, libopenxr1-monado が必要か?)
  - OpenXR + monado
    - https://monado.freedesktop.org/getting-started.html#about-openxr-and-monado
    - monado の target_list.c に XREAL_AIR あり

参考：

Steam DeckとNreal Air(XREAL Air)のみでSteamVRをプレイできるドライバー「OpenVR-xrealAirGlassesHMD」を試してみた

SteamVR以外

XREAL Air Linux Game Driver
spidgets-3dof (Example app and hardware integrations for AR in a web browser with 3 degrees of freedom)
headset-utils (Library for communicating with various AR headsets and abstracting common utilities that can be used by other applications)
Breezy Desktop (virtual workspace solution for Linux desktops)
- GNOMEのデスクトップを3DoF化するBreezy GNOMEが実用的ですごい

Windows

(2023-10-06)

SteamVR

XREAL Air の 3DOF 情報：XREAL Air-> PhoenixHeadTracker -[UDP]-> OpenTrack -> SteamVR

Install:

Install Steam
1. Install SteamVR
Install PhoenixHeadTracker
1. フォルダを指定して展開
Install Opentrack
1. フォルダを指定して展開
Install SteamVR.OpenTrack.FreeTrack.1.0.zip
1. C:\Program Files (x86)\Steam\steamapps\common\SteamVR\drivers　へ展開
2. resources\settings\default.vrsettings を修正
  1. DistortionK1, DistortionK2 -> 0
  2. FOV -> 40 (46だと少し小さめに表示される)
  3. renderWidth -> 1920
  4. windowWidth -> 3840
  5. windowX -> 1920 (1920x1080 のメイン画面の右に表示)

起動:

XREAL Air を PC に USB-c で接続
1. Windows 設定：スクリーン：拡張画面（この時点で 1920x1080）
2. 輝度+ を長押しで 3840x1080 へ
PhoenixHeadTracker 起動
1. CONNECT -> 動作確認
2. Start Opentrack UDP
OpenTrack 起動
1. Options
  1. ShortCut : Center -> “-” (中央に戻すときのショートカットキーを登録)
  2. Output : Pitch : Invert -> ON
2. Start
SteamVR 起動
1. コントローラ接続

参考：

Ubuntu on WSL2

SteamVR

調査中

Steam を最初に起動した際にログインウィンドゥが開かずにループ

Install Linux Steam on WSL2 through Windows - Ask Ubuntu

CloudXR

リンク

番外編

XREAL Air ＋Xreal Beam で楽譜表示

楽譜を PNG に変換し、PC から Beam へコピーしておけば XREAL Air で表示できる。譜面台なしで演奏可能だが、周囲の人からはサングラスをかけていると勘違いされていた。

※解像度不足で5線が消えて見えない場合あり。Beam で使える PDFリーダが欲しい。

XREAL Air + Hagibis TPS01 + Minisforum S-100 でモバイルコンピューティング

(2025-02-13)

スティック PC S-100 にひとつだけある type-C ポート（USB3.2 ）は DP Alt モード対応だが、普段は電源入力で使用されている（POE 対応なので Ethernet ケーブルからの給電も可能だが，モバイル用途には別途アダプターが必要）。

TPS01 経由だと電源アダプターと Xreal Air を同時に接続可能となり、あとはマウスやキーボードを接続すればディスプレイいらずで作業できる。もちろん XREAL Hub でも可能なはず。

※DP Alt モード type-C USB ポートを持つ極小ミニPCは現時点であまりない。

参考：

XREAL OneでもHAGiBiS TPS01買っとけば問題ない

Google Sites

Report abuse