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.
• A built-in sampler stores custom one-shots and loops (import files or grab chops from a live deck).
• 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, Phase lock, Set Cue, Align on mix, and Shock mix apply to auto mixes only — in manual you're in control of the blend.

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

Start Session first: In manual mode, Load Deck A / B does nothing until the session is started. If you try to load early, the app shows a reminder to press Start Session, then load your track. Starting from DJ Phone syncs the desktop session, so that reminder does not appear after a remote start.

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.

Next to Loop In / Loop Out / Loop on each deck:

While an auto-loop is active, click the same button again to exit. Ctrl+click halves the loop length; Shift+click doubles it (up to 64 beats). Needs a known BPM on that deck.

Closing the app window shows an in-app Exit confirm (session stops if you exit).

Crowd energy slider

On the second row under Phrase / Bar / Set arc / Mashup (session controls), the Crowd slider is 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.

Mashup (Creative)

Next to Set arc, the Mashup dropdown can run Creative stem choreography during auto mixes:

Requirements

• Local library files on both decks (not YouTube streams).
• Stems separated and ready on both decks (library stem button → Stems ready).
• Auto mix mode (not manual).

Also: While Mashup is Creative, Shock mix is disabled (the checkbox and style/trigger dropdowns grey out). Shock and creative stem mixes can't run together. Turning Mashup back to Off restores your previous Shock mix setting.

Saved in browser localStorage on this machine.

Next to the session buttons you'll see Phrase, Bar, Phase lock, Set arc, and Mashup. Under the waveforms, in the Beat match bar (beside Align on mix and Shock mix), four small beat dots (1–2–3–4) show where you are in the current bar on the playing track.

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 in the Beat match bar pulse with the live track — a visual pulse for the room. They follow your Bar setting (4 or 8 beats).

Beat grid editor

Under the waveforms, the Grid toolbar lets you correct and refine the beat grid. Auto mix (Align on mix, Phrase/Bar, Phase lock) uses the same BPM + downbeat origin you save here — fixing the grid makes mixes more accurate.

Tip: Zoom in, scrub to a clear kick, press 1, then Save. Green/blue dots are your manual marks; amber triangles are bar starts.

When Shock mix is enabled (checkbox next to Align on mix), auto mode can replace a long blend with a hard transition when the next track qualifies.

Trigger

Style

Works on automatic track changes and when you press Next Track. Requires genre tags for genre-based detection (run Analyze or set genres in the library).

When Shock mix is off (or the next track doesn't qualify for a shock): auto mixes use a slow overlap — longer fade, ease to center so both decks are audible, hold briefly, then finish. The app also tries to start the blend before a beatless outro (vocals-only / soft tail) so the groove doesn't collapse mid-mix.

Disabled while Mashup is Creative — the Shock mix controls grey out until Mashup is set back to Off.

In auto mode there are no Manual Xfade / Next / Set Cue faders — fade timing is always waveform-driven.

Fade out (outgoing track)

The app reads the live track's waveform and starts the fade where energy drops in the tail — ideally before a beatless or near-silent outro. Deck time can count down to fade. An orange Fade marker shows the blend start on the live waveform.

Pressing Next Track starts the blend now (no phrase wait, no beat-bar stall). The next track is already soft-loaded on the idle deck at session start, so Deck B (or A) can take over as soon as you press Next.

Set Cue — where the new song starts

Set Cue lives in the session toolbar (next to Mashup). Choose how the app picks the mix-in point:

Mix-in points (except Beginning) come from waveform analysis, then align to the outgoing fade window and snap to Phrase / Bar when beat alignment is on. Cap is about 2 minutes into a track so intros aren't 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.

Deck playheads

Deck waveforms keep the playhead centered while you scrub or play (viewport follows the track). Near the end of a track, the playhead walks toward the right edge again so you can see the outro.

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 with an API key — see MC Settings → Integrations):

Remember: Never mention the old venue name.
Remember: Do not say "feel the energy."

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).
• Without API keys, the app can still use simpler template lines or basic system speech.
• Welcome when you start; track intros shortly after a new song begins (not every line names the track — you can set every N 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.

Control the booth from your phone while the desktop app stays open and connected:

1. In MC Settings, set a DJ Phone PIN (required — remote stays locked until you set one).
2. On your phone (same Wi‑Fi), open http://YOUR-PC-LAN-IP:8767/dj/mc (Crowd URL with /dj/mc).
3. Enter the PIN.

From the phone you can Start / Pause / Next, load decks, trigger MC, and tweak mix options (energy, mashup, shock, cue mode, SFX). The desktop must stay connected to the WebSocket.

Start Session from the phone: the desktop marks the session active too — you can open the Library and load / queue tracks without seeing "Start Session first."

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

Use Half / Full to dock the library to half the screen (decks stay usable) or go full-screen. In half view you can drag a track onto Deck A or Deck B to load it (manual) or queue it as next (auto).

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

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. Stream set — loads the set as the live play queue (library matches + YouTube stream fallback) and preloads BPM/key/genre where needed.
6. Download set — pick a folder; the app writes matched/downloaded audio there plus an .m3u playlist.
7. 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.
• Download — pick a folder; the app downloads the playlist audio there (same pipeline as AI Set download).
• 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 — the library Stems column shows N/A. Use single-track import (or playlist Download) for local files if you want stems.

Loading a new playlist cancels in-flight analysis/preload from the previous list so the UI doesn't stay stuck busy.

Saved Playlists

• Name your current queue → Save (including save filtered by genre when a genre filter is active).
• Add to playlist on a row appends that track into a named saved playlist.
• 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. In half-screen library you can also drag a track onto a deck to queue/load.
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.

How auto picks the next song: smart selection ranks genre first, then BPM and Camelot key. After about four tracks in a row from the same genre, the picker prefers a genre switch so the set doesn't get stuck in one pocket.

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

• Use Half layout when you want to keep an eye on the decks while browsing.
• 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 (or drag onto a deck in half view).
• Album art shows when available; stem status for YouTube streams is N/A.

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.
• A GPU (NVIDIA CUDA on Windows/Linux, or Apple Silicon on Mac) speeds separation a lot when available; otherwise it runs on CPU.

How to use stems

1. Open Library and find a local track (streams show N/A in the Stems column).
2. Click Separate stems on that row — or load/play the track: the app can auto-queue separation for local files 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 with all stems on (short crossfade — no hard cut). Or click a single stem pad to enter stems with only that stem audible.
5. Click stem pads (vocals / drums / bass / other icons) to mute/unmute. Alt+click a pad to solo that part only. Same controls are under MIDI Mapping → Stems.

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.

Stem mode may sound a touch different from the original file (Demucs separation artifacts). The app applies a small makeup gain so stem mode loudness is closer to full mix.

Creative Mashup (auto mixes)

With Mashup → Creative (session bar), auto transitions can choreograph stem levels across both decks during the blend — for example keeping outgoing vocals over the incoming beat. See Mashup (Creative) above. Both decks need stems ready.

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.
• After app start, wait until decks show Stems ready before relying on Creative Mashup (stem cache syncs in the background).

Stem troubleshooting

In the center column (under the crossfader / session controls) you'll find Sound FX and Sampler.

Sound FX

Built-in one-shots (airhorn, sirens, spinback, etc.) with their own FX volume slider.

• Click a pad to fire it; several FX can overlap.
• Assign keyboard shortcuts by clicking the key label on a pad, then pressing a key.
• FX volume does not change sampler pads — the two buses are independent.

Sampler — banks and pads

Custom samples live in banks of 8 pads.

Playback tips

• Multiple pads can play at the same time (polyphonic).
• Active pads light up in different colors while sounding.
• Shortcuts on pad keys work the same as tap/hold with the mouse.
• Map pads / bank change / grab / stop-all under MIDI Mapping → Sampler (hold pads use note on/off like Cue).

Pad editor

Right-click a filled pad to edit it:

• Waveform with green start / red end trim handles
• Name, BPM, Volume, Tempo
• Sync to live track — match tempo to the current deck BPM (keeps Loop mode working)
• Single / Loop
• Play / Stop / Reset / Clear

Volume and tempo update live while a pad is playing.

Grab from a live deck

Above the pads:

Captured chops are saved as real WAV files in your sample folder, tagged with track BPM when known.

Where sampler files live

• Default: %APPDATA%\AI DJ\sampler\files\ (banks in banks.json next to it)
• Or any folder you choose with Browse… (preference saved in settings.json)

Top bar → Backup.

Export a file with playlists, settings, beat grids, API-related prefs, and (optionally) your license key.

Restore: Import the file, remap the music folder if you moved your library, then confirm. Sampler audio is restored into your current sample folder (not the path from the old PC).

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 Stream or Download it (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, Mashup Off (or Creative if both decks have stems), 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 after Start Session, blend with crossfader (center = both decks full). Use hot cues (C1–C8), auto loops (4/8), 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.

Or set Mashup → Creative with stems ready on both decks for automatic vocal-ride / bass-swap style blends.

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