百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
D

decky-XRGaming

> 编程语言
开源

Decky 插件为 XR 眼镜提供 3DoF 和 6DoF 效果

198 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

Decky 插件为 XR 眼镜提供 3DoF 和 6DoF 效果

XR Gaming Plugin

This plugin provides virtual display and head-tracking modes for the supported XR glasses by installing Breezy Desktop's Vulkan implementation. It also provides a UI for easily changing common configurations. All without leaving Game Mode.

Installation

Installation requires a Steam Deck, SteamOS device, or device running a SteamOS-compatible fork like Bazzite. If you're on a PC or device running a non-SteamOS-compatible OS, you can still install Breezy Vulkan manually, but this lacks the nicer controls provided by the plugin.

  1. Install Decky Loader on your Steam Deck.
  2. Open the decky store from the ... sidebar menu, via the tab with the plug icon, and lastly hitting the storefront icon near the top.
  3. Find "XR Gaming" and install it.

Decky Controls

Watch the video overview of the plugin, including controls and recommended settings and usage. Or, just keep reading.

From the plugin sidebar, you can control the following:

  • Change headset modes.
    • In virtual display mode, a display will be rendered in a fixed position, allowing you to move your head to look at different parts of the screen.
    • In VR-lite mode, head movements are translated to mouse (or joystick) movements for a VR-like experience in first-person games.
    • In Follow mode, games can be moved and resized, allowing you to pay attention to the world around you while gaming.
    • When disabled, your Air glasses will be display-only, no head movements will be tracked.
  • In Virtual Display mode:
    • Automatic Recentering (Supporter Tier feature). Enabling this will make the display recenter itself under certain conditions: (1) if you move your vision most of the way off the screen or (2) if you move about halfway off the screen and haven't returned to the center after a couple seconds.
    • Display size. Controls how big the screen appears. A setting of 1 will render at the game's resolution, while a higher setting zooms in (e.g. 2 for 2x zoom) and lower zooms out (e.g. 0.5 for a 50% smaller screen).
    • Recenter display button. If you don't like where your virtual display has been placed, you can use this button or multi-tap to re-center it. See "I don't like where the screen was placed, or it has drifted from where it was." for more details.
    • Advanced Settings / Movement look-ahead. In virtual display mode, Breezy automatically attempts to anticipate where the screen will be when the next frame is rendered. If you find that its default look-ahead is producing a screen that drags behind your movements or a screen that is over-eager or jittery, you can tweak this yourself. The max is capped because higher values produce jitter and become unusable.
    • Advanced Settings / Enable SBS mode (Supporter Tier feature). This toggle switch will put your glasses in or out of SBS mode. When in SBS mode, your display resolution will double in width (to 3840x1080), and each eye will show only half of the screen to allow for stereoscopic-depth-based functionality. Turning this on will enable two new controls:
      • Display distance. Uses stereoscopic depth perception to move the display closer or farther from you. You may find that a different display distance reduces eye strain. A value greater than 1 is farther away (e.g. 2 is 2x farther than the glasses' default) and less than 1 is closer (e.g. 0.5 is half the default distance).
      • Content is stretched. Enable this if your device is rendering content using the entire width of the SBS screen. For a more consistent SBS experience across games, enable this toggle, then enable stretching by going to the Deck's ... Performance menu and move the Scaling Mode slider to Stretch.
      • Content is 3D. Enable this if the game you're playing is rendering with side-by-side stereoscopic 3D support (either natively or using a third-party tool such as ReShade's Depth3D shader). This will render 3D content inside the virtual display.
  • In VR-lite mode:
    • Mouse sensitivity. Controls how much/quickly the mouse will move relative to your head movements.
    • Advanced Settings / Joystick mode. When enabled, head movements are translated to right-joystick movements on a virtual controller (use this as a fallback option if the default mouse mode controls don't work for your game).
  • In Follow mode:
    • Display position. Choose which corner of the screen to position your display.
    • Smooth follow (Supporter Tier feature). Enabling this gives the display a little more "weight" so that it doesn't move with every jerk and bump of your headset, but instead will gravitate towards the center of your vision, making for an overall more pleasant experience.
    • Display size. Choose how much of the glasses screen should be taken up by the display.
  • Advanced Settings / Recalibrate headset button. If you're experiencing drift, noisiness, or a twisting/swaying of the screen when you move, you can use this button or multi-tap to try re-calibrating your headset. See "I don't like where the screen was placed, or it has drifted from where it was." for more details.

Supported devices

See XRLinuxDriver's supported devices.

Virtual display help

  • What does virtual display mode do?
  • Will my game work?
  • Why isn't it working?
  • How can I optimize my setup for the best experience?
  • I don't like where the screen was placed, or it has drifted from where it was.
  • The screen flickers a lot when I move.
  • I can see the screen shaking when I'm sitting still.
  • The screen lags behind my head movements.
  • SBS mode isn't working

What does virtual display mode do?

Typically, when you plug your glasses directly into the Steam Deck, you get a screen that stretches to fill your glasses entirely. And since that image is always centered in your lenses, no matter how you move your head, it will always remain centered in your vision. This forces you to look around the screen using only eye movements, which can be tiring on the eyes, and blurring on the edges of the screen means you can't always easily read content that's not near the center.

Virtual display mode is intended to mimic how we play games in real life: we place a TV screen or monitor in front of us, and then we're free to look around naturally with a combination of head and eye movements. When you enable this mode, a screen will be placed in front of you like always, but now it will stay where you put it and you're free to look around how you naturally would.

Why isn't it working?

Virtual display mode only works under certain conditions. Double-check the following:

  • Are you using supported glasses? Most XREAL, VITURE, RayNeo, and TCL brand devices are supported. For more details, see the supported devices table.
  • Are your glasses plugged into your Steam Deck? Are they displaying content when games aren't running?
    • Sometimes the display on the glasses will turn off as the battery level goes down. You can verify this by hitting the Steam or ... buttons, since the Game Mode menus display no matter where the virtual screen is. If the glasses have powered down, try lowering your TDP wattage setting in the Performance panel to get more play time.
  • Is your device on the latest firmware? See the supported devices table for updating your firmware. Does the XR Gaming sidebar show your device is "connected"?
  • Have you selected the "Virtual display" headset mode in the plugin settings? Mouse, joystick, and disabled settings will all disable the virtual display.
  • Is your screen not fixed somewhere else in the room (e.g. due to changing positions or screen drift)? Maybe try re-centering your screen (see below).
  • Are you in Vulkan-only mode? If so, the visual effects will only apply over games that run on Vulkan.

How can I optimize my setup for the best experience?

Since there will always be a delay between your head movements and rendering of the display, the virtual display mode uses "look-ahead" logic to try to figure out where your head will be when the next frame is rendered. The longer it takes to get a frame rendered in your glasses, the bigger the look-ahead will need to be, which means: lower accuracy of predictions (which will cause the screen to briefly shift away from its fixed position) and higher sensitivity to movements (which will produce more shaking). So our goal is to get that latency between collecting movement data and rendering a frame with that data as low as possible. To put it another way: we want to reduce input lag.

In general, these will have the biggest impact on input lag:

  • Avoid upscaling by running at the glasses' native resolution (or native aspect ratio).
    • I found that upscaling was causing 5-10ms of additional rendering latency. I initially suspected that it was due to FSR, but in changing the Scaling setting to Linear I didn't see a noticeable improvement. For now, it seems most important to remove the upscaling step entirely.
  • Render frames as soon as they're ready by disabling all forms of VSync.
  • Increase framerate by maximizing performance settings of your games. If you want to choose a lower resolution to achieve this, be sure it's at the glasses' native aspect ratio.

Here are specific ways you can try to achieve that on the Steam Deck:

  • In Steam's Settings/Display dialog, make sure the Automatically set resolution toggle is enabled.
  • Prior to launching a game, in the Game Details view (where it shows the green "Play" button), click the Settings (cog) icon, go to the Properties view, and set the resolution to Native.
  • In the in-game Video/Graphics settings, set the resolution to 1920x1080 (or any 16:9 aspect ratio), disable VSync, and set everything to lower-quality, higher-performance settings.
  • In the Deck's ... Performance menu, flip on Disable Frame Limit (I know it's confusing to "turn on" a feature that "turns off" something, but either way the switch should be flipped to the "on" position) and enable Allow Tearing.

After you make these changes, if the display is still either lagging behind or jumping ahead of your movements or exhibiting a lot of shakiness, go into the XR Gaming plugin settings and change the Movement look-ahead setting to Min, then slowly dial it up while moving your head until the display seems to most stable.

I don't like where the screen was placed, or it has drifted from where it was.

Unfortunately, without an official SDK from XREAL, screen drift will probably remain an issue for the foreseeable future for the supported XREAL devices. The only workarounds for this currently are to either (a) keep re-centering it, or (b) try re-calibrating it.

This section will suggest you either use buttons in the plugin sidebar or use the multi-t

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScript3dof6dofarbreezy-desktop

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言