Manual

Install

1. Download the .dmg and drag Codi Switcher to Applications.
2. First launch: right-click the app → Open → Open. If macOS still refuses: System Settings → Privacy & Security → Open Anyway.
3. Or in Terminal: xattr -cr "/Applications/Codi Switcher.app"

Needs an Apple silicon Mac (M1 or newer) with macOS 13+. Settings, shows and logs live in ~/Library/Application Support/Codi Switcher/ (Settings → General → Open data folder).

Your first show

1. Connect the LED (or projector) as the Mac's external display. PROGRAM goes fullscreen on it by itself; ⌘⇧F toggles it.
2. Press Start show. It unlocks audio and opens PROGRAM.
3. Media → Shows → name it, New blank show. Set its Look: colours, font, logo.
4. Add cues with N, arm with Enter, put on air with Space.
5. Settings → General → Pre-show check before doors open.

Cues & TAKE

• PREVIEW (green) is what's armed. PROGRAM (red) is on the LED. TAKE swaps them.
• Add cue (N): Title card, Countdown, Name card, Slides, Video, Image, Website. Cameras come from Media → Live cameras.
• Transitions: Cut, Fade, Wipe, Zoom and WebGL stingers Rays, Warp, Blocks, Prism, Portal (T cycles).
• Reorder: drag a row, the row arrows, or ⌥↑ / ⌥↓. Edit (✎), duplicate or delete cues you added.
• Planned start times give a live “ahead / behind” clock. Auto-loop plays a set of cues in turn.
• Show lock (⇧L): cues still run, nothing can be edited.

Slides from Canva

1. In Canva: Share → Download → PNG, All pages. Canva saves a .zip.
2. Add cue → Slides from Canva → choose the zip. No need to unzip.
3. Each page becomes a cue, in order. Take the first; each → or clicker press is the next slide, ← goes back.

Keynote, PowerPoint and Google Slides: export images and choose them all. Animated slides: export MP4 and add a Video cue.

Scenes & look

• Title card, Countdown (M:SS, accent and a beat in the last 10 s) and Name card render live on the show's Look: the Show tab → presets, colours, font, logo.
• Change the look and scenes on air update at once. Safe hold uses the same colours and logo.
• Live effects over anything on air: Confetti, Fireworks, Sparkles, Light leak, Celebrate (⇧1–⇧5).

Music & mixer

• Audio → Add music from this Mac. Each cue can pick its track, or keep / stop the music, with a start delay so the picture comes first.
• The strip under CONTROL: Music, Video (cue sound), Box (web page), Master with limiter. Drag never jumps; Shift+drag is fine 0.1 dB; double-click = 0 dB; click the number to type.
• Audio tab: per-cue and per-track levels, ducking under video sound, 10-band EQ, output device.

Cameras & web box

• USB webcams and HDMI capture cards: Media → Live cameras → Find cameras on this Mac.
• IP cameras (RTSP / SRT): install MediaMTX (brew install mediamtx); streams arrive over WebRTC in about 0.3 s. Cameras must send H.264.
• A camera can be a cue or the Box source. The Box (W) shows any web page or camera as picture-in-picture, half or full.

Safe hold & Panic

• B = safe hold: the LED shows the show's safe screen over everything. B again releases it.
• Esc = Panic: music, Box and overlays fade out in 1 s and the LED goes to the safe screen. Esc twice cuts at once.
• Two TAKEs within 0.7 s count once. PROGRAM recovers by itself after a reload or a lost display.

Phone remote

Settings → Phone remote: scan the QR on the same Wi-Fi. Arm, TAKE, safe hold, panic, effects, music, LED colour and EQ from the floor. Share the link only with the crew.

Presenter clicker

1. Plug the clicker's receiver into the switcher Mac.
2. Settings → Presenter clicker → Clicker mode on. Use Test mode to see each button.

Next = next cue or slide, Back = back one, Blank (B / .) = safe hold, F5 ignored, Esc only panics when pressed twice. In the app, PageUp / PageDown can work even with the app in the background.

AI control (MCP)

1. Settings → AI control (MCP) → Copy Claude Code command, paste it in Terminal. Or copy the JSON for Claude Desktop, Cursor, VS Code.
2. Ask: “Show me the run sheet”, “Add a title card ‘Welcome’ and arm it”, “Cut to the countdown with Warp”, “Bring the music down 6 dB”.

Endpoint http://<mac>:8787/mcp with a Bearer token. 19 tools: read the show, add / edit / move cues, arm, take, cut_to, transitions, music, mixer, web box, effects, auto-loop, safe hold, panic. Every action shows in CONTROL as “AI · …”; safe hold, show lock and the TAKE guard still apply; switch AI off in Settings.

Shows & files

• The Show tab: new, duplicate, open and save show files (.json). Each show keeps its own run sheet, music, mixer and look.
• Music and images added from a Mac stay on that Mac; add them again on another.
• Live data from other systems (scores, check-ins) connects over WebSocket: Settings → Partner connections.

Keys

Troubleshooting

• “Codi Switcher is damaged / can't be opened”: see Install, step 2 or 3.
• LED chip red: the external display isn't connected or PROGRAM isn't fullscreen; reconnect, or ⌘⇧F.
• No sound: press Start show; pick the mixer interface in Audio → Output device; check the Master fader isn't muted.
• A video won't play: use H.264 or HEVC .mp4 / .mov (not ProRes).
• AI gets 401: copy the command again from Settings → AI control.