JaiCast Docs

Playback & DJ Modes

Dual-deck audio engine, transport controls, and four ways to run your station.

Dual-deck system with Deck A and Deck B

Dual-deck system with Deck A and Deck B.

Dual-Deck System

JaiCast uses a dual-deck architecture for gapless, crossfaded playback. The two decks work in tandem so that one track is always ready to go while another is playing.

Deck A

One of the two playback channels. Displays title, artist, artwork, waveform, and elapsed time.

Deck B

The second playback channel, pre-loaded and decoded. Ready for a seamless crossfade when the time comes.

Deck Display

Each deck shows the following information at a glance:

Cue Points

Tracks can have four cue point markers that control how they interact with crossfading and automation:

Marker Purpose
Cue In Where playback begins. Skips any dead air or unwanted intro before the music starts.
Cue Out Where the track is considered finished. Triggers the next transition.
Intro Marks the end of the intro section. Useful for talk-over timing and overlap calculation.
Outro Marks the start of the outro section. The crossfade into the next track can begin here.
Tip Set cue points in the Track Editor to fine-tune how each track enters and exits the mix. Well-placed cue points make a significant difference in broadcast quality.

Preview Deck

The preview deck lets you audition any track from the library through the CUE bus without affecting on-air output. Right-click a track and select Preview to load it into the preview deck. Audio routes to your configured CUE output device, keeping it off the main program feed.

Transport Controls

The top toolbar provides direct control over playback. These controls operate on the active deck.

Control Action
Play Start or resume playback on the current deck.
Pause Pause the current deck. The track holds its position for later resume.
Stop Stop playback and reset to the beginning. The track remains loaded on the deck.
Crossfade Trigger a manual crossfade from the playing deck to the next loaded deck.
Skip / Next Skip to the next track immediately, bypassing any remaining crossfade window.
Note In Auto DJ and AI DJ modes, transport controls remain available for manual override. Triggering a manual crossfade or skip takes priority over automated transitions.

DJ Modes

The mode selector in the toolbar determines how tracks are chosen and transitions are handled. Switch modes at any time without interrupting playback.

Auto DJ

Fully automated operation. Auto DJ pulls tracks from the rotation clock, fills the queue, and handles all crossfades without intervention. This is the default mode and the best choice for unattended operation. The rotation engine follows your configured clock wheels, rule sets, and artist separation settings to keep the output varied and compliant.

Manual

Full manual control. You load tracks into decks yourself and trigger every transition. Nothing plays automatically. This mode is designed for live DJing sessions where you want complete authority over track selection and timing.

Queue

Plays through the queue in strict order and stops when the queue is empty. Good for pre-programmed shows, voicetracks, or any situation where you have a specific playlist to run from start to finish. Crossfades still apply between tracks.

AI DJ

Claude AI curates track selection based on mood, musical flow, and deep music knowledge. The AI analyzes your library and picks tracks that work well together, going beyond simple rotation rules. It also generates liner notes for each pick, explaining why a track was chosen.

Requirement AI DJ mode requires Claude CLI availability. If Claude is not reachable, the mode falls back to standard rotation selection after a circuit breaker cooldown. The AI DJ button only appears in the toolbar when Claude is detected as available.

AI DJ uses a three-tier curation system:

  1. Tier 1 — MCP Session: Full agentic research with web search and tool use. Highest quality curation with a 300-second timeout.
  2. Tier 2 — Candidate List: Claude selects from a provided candidate list without MCP tools. Faster, with a 90-second timeout.
  3. Tier 3 — Rotation Fallback: If both AI tiers fail or time out, the system falls back to standard rotation logic to keep the station running.

Crossfading

Crossfading blends the outgoing and incoming tracks together for a smooth transition. JaiCast handles crossfades automatically between every track pair, with full control over how they behave.

Fade Curves

Choose the shape of the volume transition between tracks:

Configuration

Tip Configure crossfade settings under Settings > Cross Fading. If you have well-defined Intro and Outro cue points on your tracks, the engine can produce broadcast-quality transitions automatically.

Gap Killer

The gap killer removes silence from the beginning and end of tracks to ensure seamless, tight transitions. Dead air at track boundaries is one of the most noticeable problems in automated radio, and the gap killer eliminates it.

How It Works

Configuration

Note Gap killer settings are found under Settings > Gap Killer. If a track has Cue In and Cue Out points set, those take precedence over gap killer trimming for that track.