Immersive astronomy experiences in virtual and augmented reality
Nyx provides cutting-edge VR and AR features that transform how you experience the cosmos. This guide covers setup, usage, and best practices for immersive astronomical exploration.
Table of Contents#
- Overview
- Supported Devices
- VR Planetarium
- AR Star Finder
- Mixed Reality Features
- Controls and Navigation
- Best Practices
- Troubleshooting
Overview#
VR Features#
- Immersive Planetarium: Full 360° sky experience
- Solar System Explorer: Walk among the planets
- Scale Demonstrations: Feel the vastness of space
- Guided VR Tours: Narrated cosmic journeys
- Multiplayer Viewing: Share experiences with others
AR Features#
- Live Sky Overlay: See star names in your camera view
- Object Identification: Point and discover
- Constellation Drawing: AR constellation lines
- Planet Finder: Locate planets in daylight
- Time Lapse: See the sky change over time
Supported Devices#
VR Headsets#
| Device | Support Level | Notes |
|---|---|---|
| Meta Quest 3 | Full | Native app, hand tracking |
| Meta Quest 2 | Full | Native app |
| Meta Quest Pro | Full | Enhanced passthrough |
| Apple Vision Pro | Full | visionOS native |
| Valve Index | Full | Via SteamVR |
| HTC Vive Pro 2 | Full | Via SteamVR |
| PlayStation VR2 | Partial | Limited features |
| Pico 4 | Full | Native app |
AR Devices#
| Device | Support Level | Notes |
|---|---|---|
| iPhone (12+) | Full | ARKit, LiDAR recommended |
| iPhone (8-11) | Good | ARKit without LiDAR |
| iPad Pro | Full | Best tablet AR experience |
| Android (ARCore) | Full | Requires ARCore support |
| Magic Leap 2 | Full | Enterprise AR |
| HoloLens 2 | Experimental | Enterprise features |
WebXR Support#
Any WebXR-compatible browser and device:
- Chrome 79+ with WebXR
- Edge 79+ with WebXR
- Firefox Reality
- Oculus Browser
VR Planetarium#
Getting Started#
Quest/Pico (Standalone):
- Install Nyx from Meta Store / Pico Store
- Launch the app
- Allow required permissions
- Select "VR Planetarium" from menu
PC VR (SteamVR):
- Install Nyx Desktop with VR support
- Launch SteamVR
- Start Nyx and click "Enter VR"
- Put on your headset
WebXR:
- Visit nyx.oshun.io in a WebXR browser
- Click the VR headset icon
- Grant WebXR permissions
- Enter immersive mode
Planetarium Modes#
Standard Planetarium#
Stand under a realistic night sky:
┌─────────────────────────────────────────────────────────────┐
│ ★ ★ │
│ ★ ★ ★ │
│ ★ ★ ★ ★ │
│ ★ ★ ★ │
│ ★ ★ ★ │
│════════════════════════════════════════════════════════════│
│ HORIZON │
│ N E S W │
└─────────────────────────────────────────────────────────────┘
Features:
├── Realistic star rendering (millions of stars)
├── Constellation overlays
├── Horizon with compass directions
├── Ground/landscape options
└── Atmospheric effects (optional)
Dome Theater#
Classic planetarium dome experience:
- Reclined viewing position
- Presenter pointer tools
- Show scheduling
- Multi-user sessions
Zero-G Observatory#
Float in space without a horizon:
- 360° spherical view
- No up/down orientation
- Galactic plane visible
- Deep space zoom
VR Solar System Explorer#
Walk through a scale model of the solar system:
Scale Options:
| Scale | Sun Size | Earth Size | Neptune Distance |
|---|---|---|---|
| Classroom | 2m | 1.8cm | 90m |
| Museum | 10m | 9cm | 450m |
| Realistic* | 1.39Mm | 12,742km | 4.5B km |
*Realistic scale uses teleportation for navigation
Interactions:
- Walk around planets
- Resize planets with gestures
- View real-time positions
- Time-lapse orbital motion
- Land on planet surfaces
VR Tours#
Pre-built immersive experiences:
| Tour | Duration | Description |
|---|---|---|
| Cosmic Voyage | 15 min | Journey from Earth to edge of observable universe |
| Life of a Star | 20 min | Watch stellar evolution |
| Mars Landing | 10 min | Experience Perseverance landing |
| Black Hole Dive | 12 min | Approach event horizon |
| Apollo 11 Recreation | 25 min | Relive the Moon landing |
| Exoplanet Discovery | 18 min | Visit confirmed exoplanets |
AR Star Finder#
Setup#
- Open Nyx mobile app
- Tap "AR Mode" button
- Grant camera permissions
- Point device at sky
AR Interface#
┌─────────────────────────────────────────────────────────────┐
│ ○ Camera View with AR Overlay │
│ │
│ Polaris ★ │
│ ╲ │
│ ╲ Ursa Minor │
│ ╲_____★ │
│ ╲ │
│ ★ │
│ │
│ Vega ★ ★ Deneb │
│ │
│ ★ Altair │
│ │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ Looking: NE ↗ | Alt: 45° | Accuracy: High │
│ [Constellations: ON] [Labels: ON] [Info: OFF] │
└─────────────────────────────────────────────────────────────┘
AR Features#
Object Identification#
- Point at any bright star or planet
- Tap the object or wait for auto-identify
- View information overlay
┌─────────────────────────────┐
│ ★ Sirius (α Canis Majoris) │
│ Distance: 8.6 light years │
│ Magnitude: -1.46 │
│ Type: A1V (white dwarf) │
│ [More Info] [Track] │
└─────────────────────────────┘
Constellation Drawing#
Enable constellation lines overlaid on the real sky:
- Official IAU constellation lines
- Mythology-based artistic figures
- Cultural variants (Greek, Chinese, etc.)
Planet Finder#
Find planets even during daytime:
- Enable "Planet Finder" mode
- Follow the on-screen arrow
- Planet location shown through camera
Time Lapse AR#
See the sky change over time:
- Speed: 1x to 1000x
- Show star trails
- Predict positions hours ahead
- Rewind to see past sky
Compass Calibration#
For accurate AR positioning:
- Go to Settings > AR > Calibrate
- Move device in figure-8 pattern
- Point at known star to fine-tune
- Verify accuracy with second star
Mixed Reality Features#
Passthrough Planetarium#
See the real world with virtual sky overlay:
Available on:
- Meta Quest 3 / Pro
- Apple Vision Pro
- Other passthrough-capable devices
Features:
- Real room visible beneath virtual sky
- Walk around your space
- Anchor virtual objects to real surfaces
- Day-to-night transition effects
AR Telescope Preview#
See what your telescope will show:
- Connect Nyx to your telescope
- Enable "Telescope FOV" in AR mode
- Point phone where telescope points
- See magnified view preview
Shared AR Experience#
Multiple users see the same AR content:
- One user creates a session
- Others join via QR code
- Everyone sees synchronized overlays
- Perfect for teaching groups
Controls and Navigation#
VR Controllers#
Universal Controls (Quest, Index, Vive):
| Action | Control |
|---|---|
| Select/click | Trigger |
| Menu | Menu button |
| Teleport | Thumbstick forward + release |
| Rotate view | Thumbstick left/right |
| Zoom | Grip buttons (pinch gesture) |
| Time control | Left controller thumbstick up/down |
| Info panel | Point at object + trigger |
Hand Tracking#
Quest hand tracking gestures:
| Gesture | Action |
|---|---|
| Point | Select/highlight object |
| Pinch | Confirm selection |
| Pinch + drag | Move/rotate view |
| Two-hand pinch | Zoom in/out |
| Palm up | Show menu |
| Fist | Dismiss |
Eye Tracking#
Quest Pro / Vision Pro:
| Feature | Description |
|---|---|
| Gaze select | Look at object to highlight |
| Foveated info | Details appear where you look |
| Natural zoom | Look + pinch to zoom |
AR Touch Controls#
| Gesture | Action |
|---|---|
| Tap object | Select and show info |
| Double tap | Center on object |
| Two-finger rotate | Adjust time |
| Pinch | Zoom overlay scale |
| Long press | Options menu |
| Swipe down | Exit AR mode |
Best Practices#
VR Comfort#
Reducing motion sickness:
- Use teleport locomotion instead of smooth movement
- Enable vignette during motion
- Take breaks every 20-30 minutes
- Start with stationary experiences
- Adjust IPD for your eyes
Room setup:
- Clear 2m × 2m minimum play space
- Set guardian/boundary
- Sit for extended sessions
- Keep water nearby
AR Best Practices#
For best tracking:
- Dark location - Less light pollution
- Steady hands - Use tripod if needed
- Calibrate compass - Critical for accuracy
- Allow GPS lock - Wait for accuracy
- Update device - Latest ARKit/ARCore
Battery management:
- AR mode uses significant battery
- Keep device cool (don't cover camera)
- Use external battery for long sessions
- Reduce screen brightness
Educational VR Sessions#
For classroom use:
- Pre-plan the experience route
- Test all content beforehand
- Have hygiene wipes for shared headsets
- Provide seated experiences for all
- Have non-VR backup activities
- Monitor students for discomfort
Troubleshooting#
VR Issues#
Headset won't enter VR mode:
- Ensure SteamVR/Oculus software is running
- Check that headset is detected
- Restart Nyx application
- Update graphics drivers
Poor performance/low frame rate:
- Lower star density setting
- Disable atmospheric effects
- Reduce render resolution
- Close background applications
Tracking issues:
- Clean tracking cameras
- Improve room lighting
- Redraw guardian boundary
- Reset headset orientation
No sound:
- Check VR audio routing
- Ensure headphones connected
- Check in-app volume
- Verify system audio settings
AR Issues#
Objects in wrong positions:
- Recalibrate compass
- Verify GPS accuracy
- Check date/time settings
- Perform manual star alignment
Camera not working:
- Grant camera permissions
- Restart the app
- Check for other apps using camera
- Clear app cache
AR drifts over time:
- Recalibrate periodically
- Keep device steady
- Ensure good GPS signal
- Use reference point correction
Labels not appearing:
- Check label settings enabled
- Increase magnitude limit
- Point more directly at sky
- Wait for scene to stabilize
Performance Optimization#
Mobile AR:
Settings > AR > Performance
├── Star limit: [1000 ▼] (reduce for older devices)
├── Constellation detail: [Simple ▼]
├── Label distance: [Near only ▼]
└── Frame rate target: [30 FPS ▼]
VR:
Settings > VR > Performance
├── Render scale: [1.0 ▼] (reduce to 0.8 for better performance)
├── Star count: [100k ▼]
├── Shadow quality: [Off ▼]
├── Anti-aliasing: [2x ▼]
└── Atmospheric scattering: [Off ▼]
Additional Resources#
VR Demo Videos#
AR Tutorials#
Community#
- VR astronomy Discord: discord.gg/nyx-vr
- AR feature requests: github.com/oshun/nyx/discussions
- VR content creators: #NyxVR on social media