Setup guide

How to connect SpatialEMU to a self-hosted FolioSpace server

To connect SpatialEMU, first make sure your FolioSpace Library is running and reachable from the device. Open the FolioSpace connection screen in SpatialEMU, enter the server address and any credentials you control, save the connection, and load the catalog. Keep private URLs, credentials, and tokens out of screenshots and support messages.

Verified facts

What is confirmed

RequirementA running FolioSpace Library you are authorized to use
NetworkThe SpatialEMU device must be able to reach the server
CredentialsProvided and controlled by the server operator
Public test tokenNot published on this website

Facts last verified

Steps

How to proceed

  1. Check the serverOpen FolioSpace Library from an authorized device and confirm it responds.
  2. Check the networkPlace the SpatialEMU client on a network path that can reach the server.
  3. Add the connectionEnter the full server address and required credentials in SpatialEMU.
  4. Load and verifyRefresh the library and confirm expected entries appear.
  5. Troubleshoot safelyReport versions and errors without sharing credentials, tokens, or private addresses.

Boundaries

What SpatialEMU does not provide

  • Games, ROMs, BIOS files, firmware, and third-party download catalogs are not included.
  • Users must provide files they have the right to use.
  • On iPhone, iPad and Vision Pro, supported battery saves and play records can synchronize through your configured FolioSpace Library. Server support, the game and save format matter; this is not universal save-state sync or seamless continuation. Keep backups.
  • On visionOS, export PNG images or H.264/HEVC video with game audio from supported game views. This is a flat composition, not a recording of the entire spatial environment. 3DS video capture requires 2D mode; availability depends on the runtime.
  • Intel Macs are not supported.
  • The Windows installer is currently unsigned.
  • Android is in development and is not available for download.

FAQ

Common questions

Why is my catalog empty?

Confirm the server contains a library, the client can reach it, and the account or token has the required access.

Can support configure my NAS?

No. SpatialEMU does not manage NAS, Docker, firewall, DNS, or remote-access configuration.

Should I share my token?

No. Treat server credentials and tokens as private.

Next step