AI DJ Pro — User Guide

AI DJ Pro is a DJ app on your computer. It plays your music, mixes from song to song, and can act like a real host with spoken announcements.

• Your music stays on your PC (local files or YouTube playlists you add).
• The app picks the next song and blends tracks so the energy keeps flowing.
• Optional stem separation lets you mute or solo vocals, drums, bass, and other parts on local tracks.
• An optional MC (host voice) can welcome guests, hype tracks, and thank everyone at the end.

1. Open the app and wait until it connects (the startup screen should clear).
2. Library — add music: point to a folder on your computer, or paste a YouTube playlist link.
3. Optional: run Analyze on tracks missing BPM/key info (helps smarter mixing).
4. Press Start Session.
5. Let it run. Use Pause if you need a break; Next Track to skip early; End Session when you're done.

That's enough for a hands-off party. Everything below helps you tune the vibe.

Auto mix (recommended for parties)

• Chooses the next song.
• Fades between tracks on its own.
• Shows which deck is live and next in the library.

You control the session (start, pause, skip, end) and settings (energy, MC, mix feel).

Manual mix (for hands-on DJing)

You load songs onto Deck A and Deck B and blend them with the crossfader — like a traditional DJ controller.

• Next Track is off in manual mode.
• Phrase, Bar, and the Xfade faders don't apply; you're in control.

Switch modes with the Auto / Manual dropdown on the crossfader panel.

Crossfader in manual mode: At center, both decks stay at full volume — fading only begins when you move past center toward Deck A (left) or Deck B (right). This gives you a wide both playing zone for overlays and doubles.

Each deck has an Effects panel (expand with ▼ under the EQ) and a separate Filter panel.

Effect knobs (two rows)

Turn a knob up to add that effect; all effects can run in parallel. Use D.Time and D.Feedback to shape the main delay. Echo uses a BPM-synced stereo ping-pong delay (dotted-eighth to quarter-note range based on the track's BPM). Repeats are filtered so they stay musical rather than harsh.

FX bypass button

When the Effects panel is open, a round FX button appears under each deck's volume fader. Click it to bypass all effects on that deck without resetting your knob positions — click again to turn effects back on.

Filter panel

Enable Filter on a deck for low-pass, high-pass, or band-pass sweeps (separate from the effect knobs).

Each deck has 8 hot cue buttons (C1–C8) below the waveform.

1. Move the playhead where you want a cue.
2. Shift+click a cue button (or use Shift+1 through Shift+8) to store that position.
3. Click the lit cue button to jump back instantly.

Hot cues are saved per track in the browser.

Crowd energy slider

A simple 0–100 control for how hyped the room feels. Higher = the app leans toward faster, punchier picks. Lower = calmer choices.

Set arc

Tells the app what kind of moment you're in:

Tip: Start with Auto. Switch to Warm up at the beginning or Cool down near the end if you want to steer the mood.

Next to the session buttons you'll see Phrase, Bar, Phase lock, and four small beat dots (1–2–3–4). These only matter in auto mix. They help transitions land on the beat so mixes sound musical, not random.

Phrase (default: 32)

How big a musical chunk the app waits for before mixing. Think of it as mixing on a musical sentence instead of mid-word.

• Lower (16–24) — quicker song changes.
• 32 — balanced default for most parties.
• Higher (48–64) — mixes on bigger section changes; fewer but smoother transitions.

Bar (default: 4)

A finer backup — aligns to bar lines (every 4 or 8 beats) when a full phrase doesn't fit in time.

Phase lock (default: Medium or High)

While two songs overlap, the app gently keeps their beats in sync. Higher = tighter sync. Off if you prefer a looser blend.

Beat dots

The four dots show where you are in the current bar on the playing track — a visual pulse for the room.

When Shock mix is enabled (checkbox next to Align on mix under the waveforms), auto mode uses a DJ-style spinback instead of a long blend when the next track qualifies.

Works on automatic track changes and when you press Next Track. The outgoing track slows like a vinyl rewind, the spinback SFX plays, then the new track drops in quickly. Requires genre tags on tracks for genre-based detection (run Analyze or set genres in the library).

Beside Master volume are three vertical sliders. They control how songs blend together in auto mode.

Xfade — how the current song ends

• Manual: You pick fade length (e.g. 8 seconds). The song blends out over that time before the next one comes in.
• Auto Xfade: The app reads the waveform and starts the fade where the track naturally quiets down — great once tracks are analyzed.
• Longer Xfade = smoother, slower transitions. Shorter = snappier changes.

Next — when you press Next Track early

Controls how fast the blend happens when you skip, not when the song ends on its own. Use a shorter Next (e.g. 4–6s) for quick skips. Keep Xfade longer for smooth automatic transitions. When Xfade is on Auto, Next shows Next Auto and follows the waveform.

Set Cue — where the new song starts

• Manual: Jump into each track at a fixed time (e.g. skip 30 seconds of intro).
• Auto Cue — general smart entry (good default).
• Drop — hits harder, clubbier entries.
• Chorus — lands on the sing-along section.

Auto Cue mix-in points are capped at 2 minutes into a track so intros don't get skipped too aggressively.

First song of the night always starts from the beginning. On the waveform: orange Fade = where the live track starts blending out; green Mix = where the next track joins in.

The MC is optional spoken announcements over the music — welcomes, track intros, occasional check-ins, goodbye.

Turning it on

1. Open MC Settings.
2. Check MC Enabled.
3. Fill in basics: Event type (wedding, club, gym, etc.) or Custom, Event Prompt, Venue name, and MC name (your DJ name).
4. Click Apply Settings.

Writing a good Event Prompt

Saturday wedding for Sam and Alex. Family-friendly — kids and grandparents here.
Upbeat but not rowdy. Mention the venue Riverside Barn once early on.
Thank the caterer Green Plate if you do a welcome.

You don't need to write scripts. The AI turns this into short, varied lines.

Stopping phrases you don't like

Do not say "hands up"
Do not say "make some noise"
Do not say "last call"

For rules you want to remember every time you open the app, also add Remember: lines (requires Mem0 enabled — see MC Settings → Integrations).

Voice setup & when the MC speaks

• ElevenLabs — add your API key and pick a voice (MC Settings → Integrations).
• OpenAI — needed for smart, varied lines (not rigid templates).
• Welcome when you start; track intros after new songs; interval lines every N minutes; goodbye when you end.
• Music ducks (gets quieter) while the MC talks, then comes back up.

1. Turn on the crowd server in settings (if not already on).
2. Click QR in the top bar and show the code.
3. Guests scan, search, and send requests.
4. You can approve requests from the Queue button.

Requested songs get priority in the mix after anything you manually queued.

Open Library from the top bar. The panel slides up full-screen with two main areas:

The left tools column starts collapsed on smaller layouts — click the ▶ tab on the left edge to show or hide it.

Library in auto mix vs manual mix

The track list changes layout and behavior depending on Auto / Manual on the crossfader panel.

Auto mix (default)

• A Deck A / Deck B status row at the top shows which deck is Playing and which is Next.
• Each track row can show Live - A/B or Next - A/B badges when that song is on a deck.
• Double-click a track: before Start Session — sets your opening song (highlighted row); during a session — loads that track on the inactive deck (for an upcoming mix).
• Right-click a track (session must be started) — queues it as the very next song, ahead of automatic picks.
• Columns show BPM, Key (Camelot), Δ (key distance from live deck), and Genre.

Manual mix

• Each row has Load Deck A and Load Deck B buttons instead of live/next badges.
• The header row shows Playing or Loaded per deck.
• Double-click and right-click queue are disabled — load tracks with the deck buttons, then blend with the crossfader.
• BPM, Key, and Genre still appear when known; the Δ column is hidden (you're choosing keys yourself).

Left panel — search and folder

• Filter by name — quick text search on title and artist.
• Music source folder — pick the default music folder or Browse to add another folder on your PC.
• Refresh — rescan the folder for new files.
• Get BPM — analyze tracks missing tempo and musical key.
• Get Genre — use AI to fill in genre for tracks with no genre (or useless labels like YouTube's Music).
• Analyze all — run full waveform/BPM/key analysis on the queue (progress bar appears when running).

AI Song Finder

Requires an OpenAI API key (see MC Settings → Integrations).

1. Type a plain-English request — e.g. upbeat wedding songs, or paste a lyric you can't name.
2. Click Search.
3. Results list matches from your library plus suggested YouTube searches.
4. From a result you can queue, set as starting track, or kick off a YouTube import for suggestions not yet in your library.
5. Load more (10) fetches additional AI suggestions.

Good for "I know the vibe but not the song title" moments.

AI Set Builder

Also requires OpenAI. Expand AI Set Builder in the left column.

1. Describe the whole night — e.g. 2-hour wedding: cocktail hour, dinner, then dance floor peak.
2. Set Tracks (6–40, default 20).
3. Click Build Set. The AI plans an ordered list with phases (warm-up, peak, etc.).
4. Review the results. Tracks already in your library are marked; YouTube suggestions may need import or streaming.
5. Click Load set as queue — replaces your current play queue with the built set and preloads BPM/key/genre where needed.
6. Click Clear before building a new set.

YouTube — download vs stream

Under Import & playlists (expand that section in the left column):

Import from YouTube (single track)

• Paste one video URL → Add.
• The app downloads the audio into your music folder as a normal local file.
• Best when you want offline playback, stems, or permanent library entries.

YouTube Playlist (stream mode)

• Paste a playlist or video URL → Resolve to preview tracks.
• Load as queue — replaces the current queue with streamed tracks (no download).
• Add to queue — appends to what you already have.
• Streams play from cache on your PC; first play of each track often takes 15–30 seconds.
• Stems are not available for streamed YouTube tracks — use single-track import for local files.

Saved Playlists

• Name your current queue → Save.
• Load a saved playlist later (local paths and YouTube stream entries are restored when still valid).

Queue and how playback works

Think of the library list as your play queue:

1. Load as queue (playlist, AI set, saved playlist) replaces the list — that order is what auto mix walks through.
2. Add to queue appends without clearing what's already there.
3. Right-click → queue next (auto mode, session running) inserts one track at the front — it plays after the current song, before other queued items.
4. Crowd requests (if enabled) can also jump the line after your manual queue.
5. × on a row removes that track from the playlist (not from your disk).
6. Drag rows to reorder visually (playlist order).

When you replace the library during a live session, the current song keeps playing until it ends or you pick something new — the app won't hijack the mix mid-song.

Starting track: In auto mode, double-click your opener before Start Session, or the app picks from the queue automatically.

Sorting and filters (right column)

Above the track list:

Camelot key and the Δ column

Key badges use the Camelot wheel (e.g. 8A, 11B) — a DJ-friendly map of musical keys. Run Get BPM to detect keys for local files; streamed tracks get key during preload.

Harmonic filter (when not off): only harmonically compatible keys stay visible (same key, adjacent numbers, or same number different letter).

Δ (key difference) — steps around the Camelot wheel from the live deck's key:

The column header shows the live reference key when available (e.g. Δ · 8A).

Per-track actions (right side of each row)

Library tips

• If the library shows loading forever after a big playlist, reconnect — cached stream tracks should still appear.
• YouTube streams need network; local files work offline.
• Switch to manual mix for full hands-on control — use Load Deck A/B on each row.

Stem separation splits a local track into four parts so you can mix like a pro DJ with isolated vocals, drums, bass, and everything else.

What you need

• A local file on your computer (MP3, WAV, FLAC, etc.). YouTube streams are not supported for stems.
• The installed app on Windows or Mac (stems are bundled in the full installer). Dev setups need extra setup — see the technical guide.

How to use stems

1. Open Library and find a local track.
2. Click Separate stems on that row (or load the track and wait — separation may start in the background).
3. Watch the status under the deck pads: Preparing… → Running… → Stems ready.
4. On the deck, click Full mix to switch to Stems mode.
5. Use V / D / B / O to mute a part. Alt+click a pad to solo that part only.

Click Full mix again to return to the normal stereo track. Waveforms and BPM analysis always use the full song — only playback switches to stems.

MC + stems

When a deck is playing in Stems mode and the MC speaks, the app ducks vocals only on that deck instead of turning down the whole mix. Handy for keeping the beat while the host talks.

Good to know

• First separation on a track can take several minutes (CPU-heavy). Later loads are instant — results are cached on your machine.
• The first time ever you use stems, the app may download AI model files (~80 MB). You need an internet connection for that one-time download.
• Only one track separates at a time. Queue another and it waits its turn.
• Stems work in auto and manual mix. Pause stops stem playback along with the deck.

Stem troubleshooting

If you add an OpenAI API key (MC Settings → Integrations):

• AI Song Finder — search the library by vibe or lyric (see Music Library → AI Song Finder).
• AI Set Builder — plan a full set in one prompt and load it as your queue (see Music Library → AI Set Builder).

Core DJing works without these — they're helpers inside the Library panel.

House party (hands-off)

Auto mix, Set arc Auto, Phrase 32, MC on with a short Event Prompt, crowd QR optional.

Wedding cocktail → dancing

Start Set arc Warm up, MC with family-friendly Event Prompt and banned phrases. Switch to Peak when dancing starts; Cool down for last hour.

Club-style manual set

Manual mix, load Deck A/B from library, blend with crossfader (center = both decks full). Use hot cues (C1–C8) and deck effects for drops and transitions.

MC intro when you hit play.

Instrumental / acapella moments

Separate stems on local tracks, switch a deck to Stems, solo O (instrumental) or V (vocals) for breakdowns or MC talk-overs.

• Help button in the app → aidjpro.app/guide
• In-app log panel for status messages