Develop
Develop
Select your platform

Download and setup Meta Spatial Editor

Updated: Oct 28, 2025
Download the latest version of Spatial Editor on the Spatial SDK downloads page. By downloading, you agree to the Spatial Editor Terms.
Note: Spatial Editor is a spatial composition tool for Spatial SDK. It is not a standalone tool for creating Meta Horizon apps.

System requirements (Mac)

  • Minimum:
    • macOS 12.4 (Monterey)
    • Apple Silicon or Intel Core (2nd Gen)
    • 8GB RAM
    • GPU with Metal 2.2
  • Recommended:
    • macOS 14 (Sonoma)
    • Apple Silicon
    • 16GB RAM
    • GPU with Metal 2.2

System requirements (Windows)

  • Minimum:
    • Windows 10
    • 4 cores with SSE4.2
    • 8GB RAM
    • 4 GB VRAM with OpenGL 4.6 (AMD GCN 4th gen, Nvidia GeForce 16 series, or Intel Rocket Lake).
  • Recommended:
    • Windows 11
    • 8 cores
    • 16GB RAM
    • 8GB VRAM
  • Troubleshooting:
    • If you encounter the error: The code execution cannot proceed because VCRUNTIME.dll was not found, you can download the required Microsoft Visual C++ Redistributable package from here

Open your first Spatial Editor project

If you’re new to the Spatial SDK, follow these steps to open your first project in Spatial Editor:
  1. Download the sample projects from the Meta-Spatial-SDK-Samples GitHub repo.
  2. Navigate to Meta-Spatial-SDK-Samples/CustomComponentsSample/app/scenes.
  3. Open the Main.metaspatial file to see the project in Spatial Editor.
Note: Most of the sample projects come with a Main.metaspatial file stored inside of app/scenes/.

Understand your project structure

The scenes directory in your Spatial SDK app should contain your entire Spatial Editor project. The following screenshot shows the CustomComponentsSample project opened in Android Studio:
The scenes directory in a Spatial SDK project
You can configure builds using the Spatial SDK Gradle extension.
For further assistance understanding Spatial Editor, visit the following resources:
Did you find this page helpful?
Thumbs up icon
Thumbs down icon