Welcome to XR Workstation
Welcome to the future of personal computing. XR Workstation transforms your Android phone into a high-performance 3D spatial computer, replacing legacy laptops with an immersive environment for Android apps and professional Ubuntu Linux software.
1. System Setup (Mandatory)
To ensure high performance and prevent Android from killing your background Linux environment, you must disable the "Phantom Process Killer" using one of the two methods below.
Method A: On-Phone Toggle (Android 14+)
- Go to Settings > System > Developer options.
- Scroll down and enable the toggle: "Disable child process restrictions".
Method B: PC Command (All Versions)
If you don't see the toggle above, run this command from your computer's terminal:
- Enable USB Debugging in Developer Options.
- Connect your phone to your computer via USB.
- Run this command:
adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"
Stability Note: Settings are usually persistent, but if the Linux desktop starts crashing after a phone restart, verify these settings again.
2. Linux Environment Setup
We recommend using Termux for the best native performance.
One-Touch Setup (Termux)
- Install Termux on your phone.
- Run the provided setup script:
termux-setup-storage
cp /sdcard/Download/cleanup_and_fresh_setup.sh ~/
chmod +x cleanup_and_fresh_setup.sh
./cleanup_and_fresh_setup.sh
- To start your workstation daily, run:
bash run_workstation.sh
3. Keyboard Shortcuts & VR Calibration
| Key |
Standard Action |
CTRL + Key Action |
CTRL + ALT + Key |
| F1 |
Toggle Help/HUD |
Dual Mode (Browser) |
- |
| F3 |
- |
Toggle Linux Mode |
Increase IPD (+) |
| F4 |
- |
- |
Decrease IPD (-) |
| F5 |
- |
- |
Increase Offset |
| F6 |
- |
- |
Decrease Offset |
| F7 |
- |
- |
Increase FOV |
| F8 |
- |
- |
Decrease FOV |
| F11 |
Toggle MR Passthrough |
- |
- |
| F12 |
- |
Reset View (Recenter) |
Save VR Settings |
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.
- Vision Requirement: To use a physical keyboard, ensure F11 (MR Passthrough) is ON so you can see your hands and the keys.
- Power Tip: You can turn OFF MR Passthrough while using virtual inputs to save battery.
4. Spatial Hand Gestures
No physical controllers are required. Use your hands in front of the camera.
Precision Interaction Guide: To interact reliably, keep your hand in a relaxed "claw" shape.
Interaction Mode (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.
- 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.
- MOUSE MODE: Make a Fist with your right hand (Palm Facing Away) to toggle mouse mode ON/OFF.
- MOUSE MOVE: Stretch your fingers and move your right hand left, right, up, or down. The red persistent cursor will follow.
- MOUSE CLICK: While in mouse mode, use a quick Middle Finger Curl (0.2s) and release.
- DRAG / SCROLL: While in mouse mode, perform a Middle Finger Curl and hold for at least 0.5s. Move your hand to drag windows or scroll lists.
- RESIZE: Perform a Middle Finger Curl with both hands simultaneously. Move hands apart to enlarge or closer to shrink.
Command Mode (Right Palm Facing Camera)
- GO BACK: Curl your Middle Finger while keeping your Index finger straight (Right hand, palm facing you).
- RESET: Make a Fist (Curl both Index and Middle fingers) with your right hand (palm facing you) to reset the browser position.
5. Troubleshooting
- Black Screen in Linux: Ensure
vncserver :1 is running in Termux before toggling. Use bash run_workstation.sh to reset.
- 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 (use chest-mount or table-mount). The virtual keyboard only appears when your hands are detected.