SpaceWalker for Mac

Introduction

SpaceWalker for Mac is an application that runs on Mac and works with XR Glasses manufactured by VITURE. It allows you to project multiple virtual screens onto your XR Glasses from your Mac device, and supports multiple layout switching to adapt to your operating habits.

By default, the virtual screen is locked in space (3DoF). You can also unlock the fixation of a single direction according to your personal habits, so that the screen moves with your head.

Of course, you can also use keyboard shortcuts to adjust the size of the screen display, or reset the screen to the center of your field of view.

SpaceWalker for Mac also adds features to improve ease of use, such as automatically turning off the MacBook's display when SpaceWalker is launched, or automatically turning off the electrochromic film when it detects that you are looking down, making it easier for you to use the keyboard.

Click to download the latest version of SpaceWalker for Mac.

Getting Started

To ensure the best experience, follow these steps to get started with your XR Glasses.

Updating & Calibrating Your XR Glasses

Before you start using SpaceWalker for Mac, we recommend that you update your XR Glasses' firmware to the latest version: Firmware Update

And calibrate your XR Glasses' IMU after the update: IMU Calibration

System Requirements

Hardware: Mac with the USB-C port (with the Thunderbolt symbol), Thunderbolt 3, Thunderbolt / USB 4, and Thunderbolt 4.

Explore more at Identify the ports on your Mac.

Software: SpaceWalker for Mac v1.2.3 and later requires macOS Ventura 13.0 or higher.

If you're using macOS Monterey 12.4 or later, SpaceWalker for Mac v1.2.2 is the last compatible version. Click here to download.

Supported Languages

English, Japanese, and Simplified Chinese.

The display language defaults to English but will switch to your system language if it's supported.

What's New

The latest version of SpaceWalker for Mac is v1.3.2.

Release date: Aug 28, 2024

Release notes:

macOS Sequoia Beta Compatibility: Adapted to the new screen recording permission introduced in macOS 15 Sequoia Beta 5 and 6.

Pro XR Glasses Enhancements: SpaceWalker now supports brightness and volume levels from 7 to 9 on the latest firmware of VITURE Pro XR Glasses, offering a wider range of adjustments.

Ultrawide Display Switching: Easily switch between 21:9 and 32:9 aspect ratios on Ultrawide displays.

HiDPI Support: Enjoy higher resolutions and sharper visuals with HiDPI support on 32:9 Ultrawide displays.

Bug Fixes and Performance Improvements:

Brightness Consistency: Resolved abnormal brightness behavior when exiting SpaceWalker with Reduce Motion Blur enabled.

Status Bar Display: Corrected display issues with the status bar.

Refresh Rate Stability: Fixed refresh rate inconsistencies during display layout switching.

Big Text Display: Addressed display issues for Big Text under Portrait-Landscape-Portrait (extended) and Ultra-wide Paranomic modes.

Reduce Motion Blur Reliability: Ensured the Reduce Motion Blur feature functions consistently.

Multi-Display Compatibility: Resolved specific blank display issues on Mac models with Apple Silicon when using three stacked displays.

Refresh Rate Consistency: Fixed refresh rate issues when launching VR scenes on Mac models with Intel processors.

Display Alignment: Corrected alignment issues with the middle display on Mac models with Intel processors.

Installation & Launching

Download and Installation

Download the latest version of SpaceWalker for Mac: https://www.viture.com/mac.

Double-click the downloaded .dmg file.

Drag the SpaceWalker icon to the Applications folder.

Double-click the SpaceWalker icon in Applications to launch the app.

Granting Screen Recording Permission

SpaceWalker requires Screen Recording permission to display the virtual screens on your XR Glasses. Here's how to grant permission:

Open System Settings (Apple menu > System Settings or System Preferences).

Click on "Security & Privacy" in the sidebar.

Under "Privacy," select "Screen Recording."

Find "SpaceWalker" in the list and check the box next to it to grant permission. If the box is locked, click the lock icon in the bottom left corner and enter your administrator password to unlock it.

Connecting Your XR Glasses:

① Connect your XR Glasses following the instructions for your specific model:

VITURE Pro XR Glasses: Clip the magnetic connector to the XR Glasses.

VITURE One XR Glasses: Clip the magnetic connector to the XR Glasses.

VITURE One Lite XR Glasses: Insert the USB-C connector into the Lite XR Glasses.

② Connect the USB-C connector from your XR Glasses to a Thunderbolt 3 or later port on your Mac (identified by the Thunderbolt symbol).

③ If you can't proceed, try using a different Thunderbolt 3 or later port on your Mac.

Selecting Display Layouts

Once connected, you'll be presented with various display layout options on the launch page. Choose your preferred layout:

Single Display: Mirrors your Mac's display or extends desktop on your XR Glasses.

2 Displays Side by Side: Two displays arranged horizontally side-by-side.

3 Displays Side by Side: Three displays arranged horizontally side-by-side.

3 Stacked Display: Three displays stacked vertically.

Ultra Wide Panoramic Display: A wide display format (32:9 aspect ratio).

Portrait-Landscape-Portrait (Coding Mode): Two portrait displays on the sides and a landscape display in the middle.

Selecting A Refresh Rate

For VITURE Pro XR Glasses, SpaceWalker allows you to choose a refresh rate (120Hz, 90Hz, or 60Hz) each time you launch the app. Conveniently, SpaceWalker remembers your last chosen refresh rate and sets it by default on launch.

SpaceWalker prioritizes your system preferences for refresh rate settings. This means that any adjustments you make within the app will override the system settings only while SpaceWalker is running. Once you quit the app, the refresh rate will revert back to what's configured in System Preferences.

For instance, if you set 60Hz for Pro XR Glasses in System Preferences, but choose 120Hz within SpaceWalker, your XR Glasses will run at 120Hz while the app is open. When you quit SpaceWalker, it will revert to the system-wide setting (60Hz).

Modifying the refresh rate within SpaceWalker while the app is running is currently not available. To apply a new refresh rate setting, please reconnect your VITURE Pro XR Glasses.

Mirroring or Extending Your Desktop

You can also choose what appears on your XR Glasses.

Mirror Display: Duplicate your Mac's built-in display onto the XR Glasses.

Extend Desktop: Extend your workspace onto the XR Glasses for additional screen real estate.

SpaceWalker remembers your last used settings and will automatically select them upon launch.

Quick Controls

You can quickly access the settings by clicking the SpaceWalker icon in the menu bar.

For VITURE Pro XR Glasses users on SpaceWalker for Mac v1.2.2 or later, the current refresh rate will be displayed here.

Switching Display Layouts

You can quickly switch between six display layouts from the menu bar. Open windows will remain open when you change layouts.

Moving the Displays

Use the menu bar or keyboard shortcuts to move displays closer or further apart (like making them bigger or smaller).

Move displays closer (Make displays bigger): Control-Option-Command-↑ (⌥+⌃+⌘+↑)

Move displays further (Make displays smaller): Control-Option-Command-↓ (⌥+⌃+⌘+↓)

Recentering Displays

Press Control-Option-Command-R (⌥+⌃+⌘+R) to recenter the displays on your XR Glasses.

You'll receive a notification to recenter the displays if they move outside your field of vision.

XR Glasses Calibration

Starting with version 1.2.2, SpaceWalker for Mac offers a new calibration feature to calibrate the XR Glasses.

Calibration fixes drift, which is the gradual movement of the display over time. Unlike Recenter (Ctrl-Alt-Cmd-R) which adjusts the center point for your current position, calibration aims to improve long-term stability. If you plan to stay in a fixed position while using SpaceWalker, calibration is recommended.

Calibration Steps:

Find a comfortable spot: Set up in a comfortable position for using SpaceWalker.

Start the app and Recenter (optional): Wear your XR Glasses and launch the app. If the displays aren't centered, use Recenter (Ctrl-Alt-Cmd-R) to adjust them.

Calibrate: Use the calibration shortcut key (Ctrl-Alt-Cmd-C). Remember your current approximate position.

Repeat for better results (optional): Continue using SpaceWalker for a while, then return to your initial position and perform calibration again. The frequency of calibration depends on your individual needs. Repeating steps 3 and 4 can further improve calibration.

Recentering or disconnecting your XR Glasses will clear the calibration data. You'll need to recalibrate following these steps again.

If you plan to stay in a fixed position while using SpaceWalker, calibration is recommended for long-term stability.

However, recentering remains useful for occasional adjustments based on your posture changes.

Features

Head-down Transparency

Enable this feature to momentarily see through the XR Glasses when you tilt your head down, making it easier to type on a keyboard while wearing them.

Note: This feature is available on VITURE Pro XR Glasses and VITURE One XR Glasses, not Lite XR Glasses.

Auto-disable Built-in Display

Turn off your Mac's built-in display while using SpaceWalker (except in Extend Desktop mode).

Note: Due to changes in macOS Sequoia, auto-disable built-in display is currently unavailable within SpaceWalker.

Shake Cursor to Center

Can't find your cursor? Shake your mouse or make circles on the Trackpad to bring it back to the center of the screen.

Reduce Motion Blur

If you experience discomfort while turning your head quickly, enable 'Reduce Motion Blur' to minimize motion blur and eye strain.

Be aware that this feature may slightly darken the display on your XR Glasses.

This feature is available starting from version 1.2.2.

Smooth Follow

Enable 'Smooth Follow' for virtual displays to seamlessly follow your head movements, similar to a tripod.

However, this feature automatically disables 3DoF functionality. Therefore, we recommend using Smooth Follow only with single display layout, not layouts like 3 displays or the ultra-wide display.

This feature is available starting from version 1.2.2.

Lock Movements

SpaceWalker allows you to "pin" the displays in a specific position using three degrees of freedom. You can also lock movements if you want the displays to stay fixed regardless of your head movement.

Lock/Unlock Left and Right Directions (Yaw): Control-Option-Command-1

Locks/Unlocks movement when turning your head left or right.

Lock/Unlock Up and Down Directions (Pitch): Control-Option-Command-2

Locks/Unlocks movement when tilting your head up or down.

Lock/Unlock Head Side Rotation (Roll): Control-Option-Command-3

Locks/Unlocks movement when tilting your head to your shoulder.

Screen Recording

SpaceWalker offers a variety of visually-appealing display layouts and built-in support for 3 degrees of freedom (3DoF). If you want to capture your point of view and share it with others, follow these steps:

Preparing Screen Recording

Ensure you have QuickTime Player installed on your Mac.

Recording System Audio (Optional): We recommend using Background Music to capture system audio. Download the latest version here.

After installation, connect to your XR Glasses, then click the menu bar on your Mac and select "VITURE" as the Output Device.

You can record system audio with Background Music. With Background Music running, launch QuickTime Player and select File > New Audio Recording (or New Screen Recording, New Movie Recording). Then click the dropdown menu (⌄) next to the record button and select Background Music as the input device.

You can record system audio and a microphone together by creating an aggregate device that combines your input device (usually Built-in Input) with the Background Music device. You can create the aggregate device using the Audio MIDI Setup utility under /Applications/Utilities.

Starting Screen Recording

Open QuickTime Player.

Go to File > New Screen Recording from the menu bar, or use the shortcut Control-Command-N to start a new screen recording.

If you have Background Music installed on your Mac, click "Options". Under Microphone, select "Background Music (UI Sounds)".

Choose "Record the entire screen".

Press the shortcut Control-Option-Command-0 (⌃ + ⌥ + ⌘ + 0) to begin recording.

Double-click the center of your screen to confirm and start recording.

To stop recording, click the red Stop Recording button in the menu bar (at the top right of your screen).

Other Settings

Access these options within the SpaceWalker app menus.

Restore Default Settings

Resets all SpaceWalker settings to their original state.

Check For Updates

SpaceWalker will notify you when a new update is available. You can also manually check for updates here. Downloading the latest version is available upon clicking "Update."

Send Feedback

Report any issues you encounter while using SpaceWalker. Clicking this option will send anonymous log files to VITURE to help us improve the software. Log files do not contain any personal information.