A rough but functional visionOS app that lets you walk inside large USDZ models on Apple Vision Pro using a game controller for movement.

Stars

51

7-day growth

No data

Forks

3

Open issues

0

License

No data

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides game-like locomotion (controller-based movement, terrain follow, speed toggle) for immersive exploration of large 3D scans, addressing a gap in native visionOS model viewing.

Who it is for

  • visionOS developers building immersive experiences
  • hobbyists with large USDZ 3D scans (house scans, terrain)
  • users wanting to prototype walkthroughs on Vision Pro

Use cases

  • Exploring interior house scans or architectural models
  • Walking over terrain or landscape models
  • Testing game controller-based navigation in visionOS

Strengths

  • Full game controller support (movement, look, height, speed modes)
  • Terrain-follow mode keeps height snapped to ground
  • Built for large USDZ models, not just small objects
  • Free and open-source starting point for custom immersive apps

Considerations

  • Requires manual file setup (drag .usdz into Xcode, edit code)
  • Needs visionOS 2.5+ and a physical game controller
  • App is 'rough around the edges' with minimal polish or documentation

README quick start

Prospector

A little visionOS app for walking around inside large USDZ models (house scans, terrain, etc.) on Apple Vision Pro, with game controller support for movement.

I built this for myself (well, I vibe coded it so if any code is janky please don't yell at me), so it's rough around the edges and not the most straightforward to use, but it should be a fun starting point if you want to explore your own large models in an immersive space.

Setup

  1. Drag your .usdz file into the Prospector folder in Xcode.
  2. Set modelName at the top of ImmersiveView.swift to your file's name (without the extension).
  3. Set your development team in the project's Signing & Capabilities settings.
  4. Build and run on Apple Vision Pro (visionOS 2.5+).

Controls

Pair a game controller (e.g. a DualSense or Xbox controller) with your Vision Pro. Movement is relative to the direction you're looking.

InputAction
Left thumbstickMove
Right thumbstickLook (yaw)
Left / right triggerMove down / up
D-pad upReset height to the terrain surface
D-pad rightToggle terrain follow (height snaps to the ground as you move)
D-pad leftToggle speed mode (6× movement)

You can also pinch your thumb and middle finger together for half a second (either hand) to toggle the model's visibility.

Credits

The environment skybox is the Meadow 2 HDRI from Poly Haven (CC0).

Description

A visionOS app to preview large scale models in real life (like housing plans!)

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20