← Back to Documentation

VJ Mode

VJ Mode transforms Ghost Arcade into a 16-channel clip launcher built for live performance. Organize your visuals into a 4-layer by 8-column grid, trigger clips on the fly, crossfade between them, and recall entire scenes with compositions and stage presets. Combined with BPM-synced sequencing and audio reactivity, VJ Mode gives you full control over your visual set without ever touching a timeline.

Clip Grid

The clip grid is the core of VJ Mode. It presents 4 rows (one per layer) and 8 columns, giving you 32 clip slots to work with. Each slot can hold any layer type supported by Ghost Arcade: ISF shaders, media files, 3D models, gaussian splats, text, SVG, color, screen capture, or any other content source.

To load a clip, right-click an empty slot and choose a content source or drag a file directly onto it. The slot stores the complete layer configuration, including all parameters, effects, and blend settings. This means each clip is self-contained and ready to perform the moment you trigger it.

Click a slot to trigger the clip on that layer. The active clip highlights to show what is currently live. Click the same slot again to stop it. Only one clip per layer plays at a time. When you trigger a new clip on a layer that already has one active, the transition between them is governed by the crossfade setting.

Crossfades

When you switch between clips on the same layer, VJ Mode can smoothly crossfade from the outgoing clip to the incoming one. This prevents hard cuts and keeps your visuals fluid during a performance.

The crossfade duration is adjustable per layer. Set it to zero for instant switching or increase it for long, cinematic dissolves. During the crossfade, both the old and new clip render simultaneously, with their opacities blending over the configured duration.

Compositions

A composition is a snapshot of the current state of all active clips across every layer. It captures which clip is playing on each row, so you can recall an entire visual scene with a single click.

Use compositions to build discrete visual moments for your set. For example, save one composition for a verse, another for the chorus, and a third for the drop. During the performance, switch between compositions to move through your visual arrangement in sync with the music.

To save a composition, set up the clips you want active on each layer, then click the save button in the compositions panel. Give it a name and it becomes available for instant recall. Compositions can be reordered, renamed, and overwritten as your set evolves.

Stage Presets

Stage presets go deeper than compositions. Where a composition stores which clips are active, a stage preset saves the complete multi-layer configuration: all parameter values, effect chains, blend modes, warp settings, and layer ordering.

Think of stage presets as entire scene files you can switch between during a live show. Use them for song-level transitions. Your opening song might use a minimal black-and-white shader setup, while the next track calls for full-color 3D models with heavy post-processing. Each of those is a different stage preset, and switching between them is instantaneous.

Presets are saved locally and persist between sessions. You can build your entire show file in advance and load it on performance day with confidence that everything is exactly where you left it.

Layer Sequencer

The layer sequencer adds timeline-based automation to VJ Mode. It syncs to BPM and lets you program clip transitions and layer visibility changes on a beat grid.

Set your BPM (manually or via tap tempo) and the sequencer quantizes all events to the beat grid. You can configure the time signature to match your music: 4/4 for standard electronic, 3/4 for waltz-time, or any other meter you need.

Place clip triggers on the timeline to automate which clips fire and when. Automate layer visibility to bring layers in and out on specific beats. The sequencer loops over a configurable bar count, giving you repeating visual patterns that stay locked to the rhythm.

The sequencer runs alongside manual clip triggering. You can let it handle the foundational rhythm while you improvise on top with live clip changes and composition recalls.

Audio Integration in VJ Mode

Connect a microphone or system audio input to make your visuals react to sound in real time. Ghost Arcade analyzes the incoming audio signal for beat detection, frequency bands, and overall amplitude.

In VJ Mode, audio reactivity can drive clip triggering: configure a clip to fire on detected beats so the visuals follow the kick drum or snare. You can also route audio data into parameter modulation, letting the bass frequencies control a shader parameter or the treble drive an effect intensity.

Audio settings are configured in the MIDI & Audio panel. See the MIDI & Audio documentation for detailed setup instructions and routing options.

Tips for Live Performance

  • Pre-load all clips before the show. Load every clip slot in advance so there is no file I/O during the performance. This ensures instant triggering with zero lag.
  • Use compositions for song sections. Map your verse, chorus, bridge, and drop to separate compositions. Switch between them to follow the musical structure without scrambling to trigger individual clips.
  • Use stage presets for song transitions. When moving between tracks with different visual aesthetics, recall a stage preset to swap the entire layer configuration at once instead of adjusting individual layers.
  • Set up MIDI triggers for hands-free operation. Map clip slots, compositions, and stage presets to MIDI controller buttons. This frees you from the mouse and lets you perform visuals with physical hardware, keeping your eyes on the projection.
  • Layer the sequencer with manual triggering. Let the sequencer handle repetitive rhythmic patterns on one or two layers while you manually trigger accent clips and compositions on the remaining layers. This gives your set a consistent pulse with room for improvisation.
  • Test your crossfade durations in rehearsal. Different content types look better with different crossfade times. Shader-to-shader transitions can be fast, while 3D model swaps often benefit from a longer dissolve. Dial these in before showtime.