User Instructions

The XR Computing Inc. XR & AI Era

Welcome to the future of personal computing. XR Workstation transforms your Android phone into a high-performance 3D spatial computer. The era of the traditional Desktop OS is over, replaced by a native, AI-powered spatial flow that spans every computing domain.

Device Compatibility: Optimized for the XR Computing Inc. ecosystem.

1. System Setup (Mandatory)

To enable the Native Android Desktop and ensure high performance, you must configure your device's Developer Options.

Enable Desktop Mode

1. Go to Settings > About Phone and tap Build Number 7 times to enable Developer Options.
2. Go to Settings > System > Developer options > Window Management .
3. Enable: "Force activities to be resizable".
4. Enable: "Enable non-resizable in multi-window".
5. Enable: "Enable freeform windows on secondary display".

Disable Phantom Process Killer (Android 12+)

This prevents Android from killing your background desktop environment. On modern devices (Android 14/15), this can be done directly in settings without a PC.

1. In Developer options, scroll down to the Apps section.
2. Locate "Disable child process restrictions" and turn it ON.
3. (Note: Turning this toggle 'ON' is what disables the killer).
4. If the toggle is missing on your device, you can use this ADB command from a PC:

   adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"

2. Launching Native Android Desktop & 4K AI Workstation

This setup allows you to run your phone's Android apps in a high-performance windowed desktop environment floating in 3D space with zero lag. Fully integrated with Gemini AI for a superior spatial productivity flow.

Select Your Resolution

Before launching, you can select your preferred productivity baseline. High resolutions require more processing power but offer significantly sharper text.

• 1080p: Standard resolution, best thermal efficiency.
• 2K: Sharp text, ideal for coding and research.
• 4K: Extreme clarity, recommended for complex multi-window workflows.

Switching: Press CTRL + ALT + 1/2/3 and restart the app to apply the new hardware buffer size.

Prerequisites

1. Install Computer Launcher Pro for desktop mode and opening multiple apps.
2. Install Termux for initialization.
3. Install UserLand if you need a professional Linux environment.

Step A: Link to System Shell (In Termux)

1. Install Termux from your app store.
2. Run: pkg install android-tools -y
3. Enable Wireless Debugging in your phone's Developer Options.
4. Open Wireless Debugging settings and tap "Pair device with pairing code".
5. Use Split Screen to keep the pairing code visible while you type in Termux:

   adb pair 127.0.0.1:[PAIR_PORT] [CODE]
   adb connect 127.0.0.1:[CONNECT_PORT]

6. Download and prepare the engine script:

   curl -O https://www.xrcomputing.tech/scripts/XRServer.sh && chmod +x XRServer.sh

7. Create a launcher shortcut script (DexLauncher.sh) to restart the desktop if it closes:

   echo 'adb shell am start --display 42 -n com.protheme.launcher.winx2.launcher/com.centsol.w10launcher.activity.SplashActivity' > DexLauncher.sh && chmod +x DexLauncher.sh

8. Run the initialization script:

   ./XRServer.sh

9. CRITICAL: After running the script, swipe away the Termux app from your recent apps list (while in split screen or after exiting) to ensure the Android Desktop takes full control of the virtual display.

Step B: Interaction & Pro Features

• WinX2 Launcher: The professional desktop environment will automatically appear on your curved screen.
• High-Res 4K/2K: You can now switch your desktop baseline to 2K or 4K for extreme clarity. See the gestures section for instructions.
• MR Blending: Use the Left Hand Fist (Palm Facing Us) gesture to blend your desktop with the real world. Black pixels will become transparent, allowing you to see through your wallpaper to your physical environment.
• Multiple Apps: By default, the desktop is optimized for multi-tasking. You can open multiple windows side-by-side.
• Linux Integration: You can launch UserLand or other Linux apps directly from this desktop.
• Restarting Launcher: If the launcher accidentally closes, you can restart it manually by running ./DexLauncher.sh in Termux.

3. Master the Sign Input System

Sign Input is the world's most advanced spatial typing system, allowing you to control your workstation with high-speed binary finger chords. No physical controllers or keyboards are required.

Core Concepts

• Binary Weights: Each finger has a value: Thumb (1), Index (2), Middle (4), Ring (8), Pinky (16).
• Typing: Combinations of these values form characters (A-Z) and symbols.
• Hand Roles: Right Hand handles Alphabet, Cursor, and Upper-layer Symbols; Left Hand handles Lower-layer Numbers, Symbols, and Global Commands.

Mode Toggles

• CURSOR MODE: Make a Right Hand Fist (Sign 31) to toggle the spatial cursor.
• LAYER TOGGLE: Make a Left Hand Fist (Sign 31) to switch between Alphabet and Numbers/Symbols.

3. Legacy Linux Environment Setup (Optional)

While most professional tools have been ported to the XR Computing Inc. ecosystem, XR Workstation retains support for legacy Linux distributions running on your Android device.

Configuring Linux Sessions

Once your Linux session is running in the background, configure XR Workstation to match its settings:

1. Open XR Workstation and use the Left Hand Pinch (Palm Facing Us) gesture to show the Help HUD.
2. Press CTRL + ALT + P and then type the Port number (Default is 5951 for UserLand) and strike ENTER.
3. Press CTRL + ALT + D and then type your Password and strike ENTER.
4. Press CTRL + F3 to enter Linux Mode. The app will automatically connect and retry indefinitely until successful.

4. Keyboard Shortcuts & VR Calibration

VR Calibration: Optics and depth adjustments (F3–F10) are now protected and require holding CTRL + ALT. Press CTRL + ALT + F12 to save your final configuration.

Note on Keyboards

While the spatial air-keyboard is highly responsive, for professional long-form coding, Bluetooth or mini wireless keyboards work robustly and are highly recommended.

• Intelligent Switching: The virtual keyboard and hand tracking will automatically hide when you use a physical keyboard to keep your workspace clear.
• Wake-Up Gesture: To bring back your virtual tools at any time, perform a Steady Pinch (Index + Thumb) with either hand and hold it for 500ms.
• MR Mode: With Mini XR glasses, MR mode is optional when using a physical keyboard. MR mode can offer a clear view replacing prescription eye glasses.

5. Spatial Hand Gestures (Experimental)

No physical controllers are required. Use your hands in front of the camera. Note: Virtual inputs (keyboard/mouse) are enabled by default, but using a physical keyboard will automatically hide them. Use of foldable Bluetooth or mini keyboards is recommended for beginners.

Global Commands & Multi-Touch

• RESET VR: Make a Fist with your right hand (Palm Toward You).
• TOGGLE HELP: Hold your Left hand stretched (Palm Toward You) for 3 seconds.
• TOGGLE MR: Make a Fist with your left hand (Palm Toward You) to toggle MR Passthrough (or press Ctrl + F11).
• SCREEN DEPTH: Palm Toward You + Middle Finger Curl (Left=Closer, Right=Further).
• MULTITOUCH MODE: Make a Fist with your right hand (Palm Away) to toggle multitouch mode ON/OFF.
• BROWSER BACK: Make a Fist with your left hand (Palm Away) to go back.
• RESIZE (Multi-Touch): Stretch your fingers with both hands (Palms Away) and move them apart/together to scale the workspace.

Keyboard Interaction (Palm Facing Away)

• TYPE / SELECT: Stretch your fingers and move your hands to hover over a key or interaction button. Use a Middle Finger Curl while hovering to strike the key.
• AUTO-TAP MODE: Hover a key for 0.8s to automatically strike it (Zero-effort typing). Toggle this by holding both hands stretched (Palms Toward You) for 1.2 seconds.
• AI SUGGESTIONS: Hover over any of the four AI word completions at the top of the keyboard and Middle Finger Curl to instantly insert the word.
• VOICE INPUT: Hover over the prominent center VOICE INPUT button and Middle Finger Curl to toggle high-accuracy speech-to-text.

Multitouch Strategy A: Curl Mode (Manual Gestures)

Directly control modes by curling specific fingers while your palm faces away.

• CLICK: Hold your hand straight and stationary for 2.0 seconds (Turns Magenta).
• SCROLL (Blue): Curl your Index Finger. Move hand to scroll.
• DRAG (Orange): Curl Middle, Ring, and Pinky (Keep Index straight). Move hand to drag.
• SELECT (Yellow): Curl Middle and Ring fingers. Move hand to select text or areas.
• LONG PRESS (Purple): Curl Ring and Pinky fingers.
• RELEASE: Stop moving your hand for 1.0 second to exit an active mode.

Multitouch Strategy B: Auto-Tap Mode (Dwell Sequence)

Switch modes automatically by holding your hand still. Toggle by holding both hands stretched (Palms Toward You) for 1.2 seconds.

• STATIONARY CYCLE: Hold your hand still for a 1.5s progressive sequence:
  • 1.5s: Blue (Scroll)
  • 3.0s: Orange (Drag)
  • 4.5s: Yellow (Select)
  • 6.0s: Magenta (Click)
  • 7.5s: Purple (Long Press)
• LATCHING: Once the desired color appears, move your hand to "lock" that mode.
• RELEASE: Stop moving your hand for 1.0 second to reset to Move (Green).

6. Troubleshooting & Safety

• MR Blending Tip: To achieve the best transparency in Mixed Reality, set both your phone's wallpaper and your desktop launcher's theme/background to Pure Black (#000000).
• Health & Safety: Do not use while walking or driving. Take a 5-minute break every 30 minutes of spatial computing to prevent eye strain. Enable "Blue Light Filter" on your phone.
• Pro Field Tip: No Wi-Fi? Simply connect to another phone's mobile hotspot to unlock the Wireless Debugging toggle. The XR Engine links via 127.0.0.1, consuming zero mobile data once started. You can use the other phone for mini keyboard too.
• Usage Note: You must keep the Linux session running in the background for the desktop to stay connected in VR.
• Experimental Status: Virtual hand-typing and spatial mouse controls are provided "AS-IS". Use physical peripherals for mission-critical productivity.
• Black Screen in Linux: Ensure your Linux app session is running and you have chosen "Cancel" on the integrated VNC popup. Use CTRL + ALT + p/d to verify your port and password match.
• Eye Protection: [IMPORTANT] We strongly recommend turning on your phone's "Blue Light Filter" or "Eye Comfort Shield" to prevent eye strain during long spatial computing sessions.
• Keyboard not showing: Ensure your hands are within the camera's FOV. The virtual keyboard only appears when your hands are detected.