Skip to content

Projects

A project is the saved state of one show — this page covers creating, opening, renaming and deleting them, and how your work gets saved.

What a project holds

Everything you set up in Moonshine belongs to the open project:

  • Projectors and their settings
  • Surfaces and the models behind them
  • Keystone, warp and selection sets
  • Masks
  • Playlists and transitions
  • Every file you upload, plus the folders you sort them into

Nothing is shared between projects. Media uploaded while one project is open does not appear in another, so a project is a complete, self-contained show.

Opening the project browser

The Projects browser lists every project on the machine.

  • On first launch, or any time no project is open, it opens by itself and stays up until you pick or create one.
  • With a project already open, click the project name in the top bar (just right of MOONSHINE) to open it.
  • Or open the command palette and run Open Projects.

Press Esc to close it again — but only when a project is already open.

Each row shows the project name, how many projectors it contains, and when it was last modified. The most recently modified project sits at the top.

Hovering a row reveals three buttons on the right:

Button What it does
Load project Opens the project
Rename project Turns the name into an editable field
Delete project Asks you to confirm, then removes the project

Clicking anywhere else on the row also loads it.

Loading a project switches it for everyone

There is one open project at a time, shared by every connected device. When you load a different project, every other person's screen switches to it too. Check who else is connected before switching mid-show — see Users and sessions.

Creating a project

  1. Click New Project in the browser header (or run New Project from the command palette).
  2. Fill in the dialog and click Create.
Field Notes
Project Name Required. Anything you like — rename it later at any time.
Initial Projectors How many projectors to create up front, from 1 to 48. You can add or remove projectors afterwards.
Resolution The output resolution given to those projectors: 1920 x 1080, 1920 x 1200, 3840 x 2160, or Custom with your own width and height.

The new project becomes the open project as soon as it is created — for you and for everyone else connected.

Projectors are created as Projector 1, Projector 2 and so on, each with its own color. Adjust position, throw ratio and the rest in Projectors.

Esc cancels the dialog.

Renaming a project

  1. Hover the row in the browser and click the rename button.
  2. Type the new name.
  3. Press Enter, or click away from the field, to commit. Esc cancels.

The new name appears in the top bar and on everyone else's screen.

Deleting a project

  1. Hover the row and click the delete button.
  2. The row's buttons are replaced by Delete and Cancel. Click Delete to confirm.

Deleting the project that is currently open leaves the app with no project, so the browser reopens and stays up until a project is chosen.

Deleting is permanent

A deleted project takes its projectors, alignment, masks, playlists and uploaded media with it. There is no undo and no recycle bin.

Saving

There is no Save button and no save shortcut. Moonshine saves for you: a couple of seconds after you change something, the whole project is written to disk, and every connected device is told the save succeeded.

The save indicator is the small dot in the top bar, to the left of the share and help buttons. Hover it for the detail.

Dot Meaning
Amber, pulsing Changes are on their way to disk, or warp edits are still waiting to be baked. The tooltip says which.
Green Everything is saved. The tooltip gives the time — "Saved just now", "Saved 12s ago", and so on.
Grey Nothing has changed since the project was opened.

If the amber tooltip mentions unbaked warp edits, that alignment work is still held in the editor and has not been committed to the output — see Baking and reverting.

If a save ever fails, a notification appears with the reason and stays on screen until you dismiss it. Check free disk space on the machine before carrying on; see Logs.

Closing the browser tab is safe

Saving happens on the machine running the show, not in your browser. Closing a tab, losing Wi-Fi or walking away mid-edit does not lose committed work. When the last device disconnects, any save still in flight is written out immediately.

Two people editing at once

Everybody connected works on the same live project. There is no personal copy to merge later and no "your version versus their version" prompt — edits are broadcast as they happen, and the automatic save that follows covers everyone's work at once.

If two people change the same value, the last change wins. To stop that happening where it matters, Moonshine hands out locks on the thing being edited: whoever takes a projector, a warp or the playback transport first owns it, and everyone else sees it as read-only until it is released. See Locks and ownership.

Before the app is connected

If the app has not yet reached the machine running the show, the browser shows a banner explaining that it is still waiting to connect, and New Project and the row buttons stay disabled. Wait for the banner to clear; if it does not, see First launch.

Next