Install & set up

Get Chapter Studio running on your Mac and Chapter Vision on your Vision Pro, and open your first project.

Requirements

App	Runs on	Requires
Chapter Studio	Mac	macOS 15 or later
Chapter Vision (includes the player)	Apple Vision Pro	visionOS 26

For live sync between the two, both devices must be on the same Wi-Fi network. Chapter Studio advertises itself on the local network only. Nothing leaves your LAN, and no account or cloud service is involved. If you only have a headset, Chapter Vision works entirely on its own; see solo mode.

Note. Corporate and hotel networks often block device-to-device discovery. If you plan to sync on the road, a personal hotspot or travel router that both devices join works well.

First launch: Chapter Studio on the Mac

Open Chapter Studio. The first time you launch, macOS may ask permission for Chapter Studio to find and communicate with devices on your local network. Allow it. This is what lets a Vision Pro discover your Mac for live sync.
Meet the Welcome window. Chapter Studio greets you with New Project, Open Project…, and your recent chapters. Click a recent to open it; a project you've moved or deleted says so and offers to remove itself from the list. If you'd rather skip the Welcome window entirely, turn on Settings ▸ General ▸ Reopen the last chapter.
Create or open a project. Choose File → Open… (⌘O) to open an existing .chapterscript bundle (double-clicking one in Finder works too), or create a new project from the Welcome window. Recent projects also appear under the File menu, so reopening yesterday's work is one click.

Once a project is open you'll see the editor: the library and scene list on the left, the source and program monitors in the center, the inspector on the right, and the full-width timeline below. The Studio workspace is the full tour. The Live control shows when the built-in live server is running, ready for a headset to connect.

First launch: Chapter Vision on the Vision Pro

Open Chapter Vision. The studio window appears in your space: a session rail on the left, the timeline and transport in the center, and an inspector on the right.
Allow local network access. visionOS asks once whether Chapter Vision may look for devices on your network. Allow it so the app can find Macs running Chapter Studio.
Choose how to work. If a Mac on the same Wi-Fi is running Chapter Studio with a project open, it appears in the session rail; select it to connect. No Mac? Open or create a .chapterscript bundle directly from Files or iCloud Drive in solo mode; Chapter Vision keeps its own recents list too.

Where projects live

A Chapter Vision project is a .chapterscript bundle. Despite the fancy extension, it is just a folder:

MyShow.chapterscript/
├── chapter.json     ← the document: segments, steps, actions, animation
└── assets/          ← your media, copied in on import

Keep bundles anywhere you like: a Projects folder, an external drive, iCloud Drive. Because a bundle is self-contained (all imported media is copied into assets/), moving or copying the folder moves the whole experience. Renaming the folder renames the project.

Watch out. Don't hand-edit or delete files inside assets/ while a project is open. Chapter Studio tracks every asset with a checksum on save, and files removed behind its back will show up as missing media.

Tip. Because a bundle is an ordinary folder of plain files, it plays nicely with backup tools and version control. Duplicate the bundle before a big restructuring session and you have an instant safety copy.

Next steps

With both apps installed, work through Your first chapter; it walks you from an empty project to a live immersive scene. If you're pairing a headset now, jump straight to Connecting a Vision Pro.