Show Files

#Saving and opening

File ▸ Save (⌘S) saves the current show.
File ▸ Save As (⇧⌘S) saves a copy under a new name.
Double-click a .cueforge file in Finder to open it.

#Show bundle format

A .cueforge show is a directory bundle (like a Keynote file). It contains:

The show document (cues, settings, routing).
A Media/ folder with copies of every audio, video, and image file used in the show. Because media is embedded, the entire show travels in one item — move the .cueforge bundle and everything comes with it.

#Media import

When you drag a file onto the cue list or use the file picker in a cue, CueForge2 copies it into the show's Media folder automatically. The original file on disk can be moved or renamed without breaking the show.

#Autosave & recovery

CueForge2 autosaves in the background. If the app quits unexpectedly, it offers to restore unsaved work the next time you open it.

#Legacy shows

Shows saved in older versions of CueForge2 (single-file .cueforge) can still be opened. On first save you will be offered the option to convert to the bundle format, which embeds media. You can decline and keep the flat format.

#Export cue sheet

File ▸ Export Cue Sheet (⇧⌘E) exports a PDF listing every cue — including cues inside groups and sub-groups, indented to show nesting — useful as a paper backup, stage manager's copy, or reference document. Multi-list shows export each list as its own section.

File ▸ Export Show Archive… zips the saved show — the .cueforge bundle and its entire Media folder — into one .cueforge.zip file you can email, AirDrop, or put on a drive or cloud share. The show is saved first so the archive matches what's on screen; a never-saved show asks you to save it before exporting. Large shows zip in the background — a confirmation appears (with "Reveal in Finder") when it's done. To open a shared archive, use File ▸ Import Show Archive… — pick the zip and CueForge2 unpacks the show next to it (adding "(2)" if a show with that name is already there) and opens it. Double-clicking the zip in Finder also works: macOS expands it to the .cueforge bundle, which you then open normally.

#Manage Media

File ▸ Manage Media… audits the show bundle's Media folder. The sheet has two sections:

ORPHANED FILES — files in Media/ that no cue references (e.g. left behind when you deleted a cue). Tick the ones you want to remove and click "Remove Selected" — that permanently deletes them from the bundle to reclaim disk space. Nothing happens without an explicit click.
MISSING FILES — cue references whose file isn't on disk. "Auto-Relink From Bundle" scans the Media folder for a name match (case-insensitive) and fixes references in place. "Replace…" on a row lets you choose a replacement file manually and rewrites every cue pointing at the old name. The bottom of the sheet has "Reveal Media Folder" to open the bundle's Media/ directory in Finder. CueForge2 does not auto-delete orphans on save — you decide when to clean up.

#Multiple cue lists

A show can contain several independent cue lists, each on its own tab. They share the same show settings, audio output routing, and media library. Each tab shows its list number and name; an amber dot means the list has unsaved changes and a green dot means it has a cue playing.

#Importing a workspace

File ▸ Import Workspace (⇧⌘I) reads a workspace created in other cue-playback software. The open panel only offers the workspace formats CueForge2 can read, so anything it lets you select will import. If the workspace has more than one cue list you can either pick a single list to import, or tick "Import all cue lists" to bring in every list at once — CueForge2 creates a matching cue list for each, named after the original list.

#What comes across

Cue names. When a cue was never given a name in the original workspace, CueForge2 names it after its media file, so audio/video cues import named after their file rather than blank.
Triggers. Continue settings are translated to CueForge2 triggers — a cue set to auto-follow the one before it imports as a Follow, auto-continue imports as a Time trigger, and everything else stays a manual GO. Follow/continue chains keep working.
Audio levels. Each cue's master level is imported as its volume.
Fade cues. Fade time and target level come across.

#Audio routing after import

The original workspace routes audio through a per-cue output matrix that doesn't map directly onto CueForge2's output channels, so each sounding cue is given a single stereo send to your first output channel — stereo files stay stereo. Re-point any cue that needs a different output in the Routing tab.