Feature knowledge base

Every feature of Alpha-DJ-Engine: what it does, how to use it, what it cannot do, the exact wording shown in the app, and the questions customers actually ask.

What this page is. A complete, structured reference for Alpha-DJ-Engine support. Each feature is one self-contained entry with a stable link, so an answer can always point at the exact section.

Keeping it current. Every released feature is documented here, and every change to a feature is reflected here. A feature that is not on this page cannot be supported.

Analysis

Track analysis

Available Since 1.0.0 macOS

Track analysis interprets each of the DJ's own audio files locally and reads its BPM, musical key (as a Camelot value), energy and loudness, so Alpha can sequence and level the set. Track analysis is the first step, labelled 01 Analyze.

What Track analysis does

Track analysis reads the selected audio files on the DJ's own computer and detects, per track, the BPM (tempo), the musical key expressed on the Camelot wheel, an energy value used to shape the set, and the loudness (LUFS) and true peak used by Match loudness. Track analysis runs entirely on the DJ's machine; the audio never leaves the computer. Nothing is written to the USB stick during this step. When analysis finishes, the DJ continues to the Composer.

How to use Track analysis

  1. Add tracks or a folder in the Source / tracks to analyze box (see Track selection).
  2. Choose the target USB drive in the USB drive / target device box.
  3. Click Analyze.
  4. When the count under ANALYZED is complete, click Open Composer to build the set.

Track analysis tooltips and on-screen text

Where it appearsExact wording in the app
Analyze step, intro linePick the folder of tracks you own. Alpha interprets BPM, key and energy locally.
Analyze step, tooltip on the Analyze buttonThis step only interprets BPM, key & energy locally. Nothing is written to the USB stick yet - writing happens in the last step (Export).
Analyze step, tooltip on the Open Composer buttonContinue to the Composer to build your set
Analyze step, tooltip on the drive chooserChoose the USB drive to write the interpreted library to

What Track analysis does not do

  • Track analysis does not upload the DJ's audio anywhere. Analysis happens locally on the DJ's computer.
  • Track analysis does not write anything to the USB stick. Writing happens only in the Export step.
  • Track analysis does not change the DJ's audio files; it only reads them.
  • Track analysis does not need an internet connection to read BPM, key, energy and loudness.

Common questions about Track analysis

Does Track analysis upload my music?
No. Track analysis runs on the DJ's own computer and the audio files never leave the machine.
Does Track analysis change or move my files?
No. Track analysis only reads the files to detect BPM, key, energy and loudness. The files are not changed, and nothing is written to the USB stick in this step.
The detected key or BPM looks wrong — why?
Key and tempo detection is automatic and can occasionally differ from the DJ's own value, especially for tracks with an ambiguous key. The value is a starting point for sequencing.

Track selection

Available Since 1.0.0 macOS

Track selection lets the DJ build the list of tracks to analyze from whole folders and from individually picked files across several folders, collected in a staging list before analysis starts.

What Track selection does

Track selection gathers the files the DJ wants in the set. The DJ can add every track from a folder, or pick individual tracks from different folders, and all chosen tracks appear in a scrollable staging list in the Source / tracks to analyze box. Tracks can be removed one by one or all at once before analysis.

How to use Track selection

  1. Click + Folder to add every track from a folder.
  2. Click + Tracks to pick individual files (multiple can be selected at once); repeat from other folders as needed.
  3. Review the staging list; remove a single track with its remove control, or use Clear to empty the list.
  4. Click Analyze to interpret the staged tracks.

Track selection tooltips and on-screen text

Where it appearsExact wording in the app
Tooltip on the + Folder buttonAdd every track from a folder
Tooltip on the + Tracks buttonAdd individual tracks (multi-select)
Tooltip on the Clear buttonRemove all
Tooltip on a staged track's remove controlRemove
Empty staging listNo tracks yet - add a folder or individual tracks.

What Track selection does not do

  • Track selection does not copy or move the chosen files. It only lists which files to analyze.
  • Track selection does not analyze the tracks on its own; analysis starts when the DJ clicks Analyze.
  • Track selection does not import from streaming services; it works with the DJ's local files.

Common questions about Track selection

Can I pick tracks from more than one folder?
Yes. Use + Tracks to add individual files, and repeat from any folder; every chosen track collects in the same staging list.
How do I remove a track I added by mistake?
Use the remove control on that track in the staging list, or use Clear to remove all of them and start over.

Sequencing

Compose

Available Since 1.0.0 macOS

Compose builds an ordered set from the analyzed tracks: the DJ draws an energy arc, sets the length, and chooses how strongly to favour harmonic mixing, then Alpha generates a sequence that follows the arc. Compose is the second step, labelled 02 Compose.

What Compose does

Compose orders the analyzed tracks into a set. The DJ picks an energy arc template and can drag its points to shape the curve, sets the target length, and adjusts two priorities. Compose then generates a track order that follows the drawn energy arc and mixes harmonically according to those priorities. The result is opened in the Refine step for review.

How to use Compose

  1. Pick an energy arc template (Journey, Wave, Build, Peak-time, Cooldown) and drag its points to shape the curve.
  2. Set the length with the minus/plus controls, or click Fit all tracks to size it to all imported tracks.
  3. Set the two priority sliders (harmonic vs. energy arc, and key vs. BPM).
  4. Click Generate to build the ordered set.

Compose settings

SettingWhere to find itDefaultRangeWhat it changes
Energy arc templateCompose, above the arcJourneyJourney / Wave / Build / Peak-time / CooldownThe shape of the energy curve the set follows.
Set lengthCompose, minus/plus control1h 00mAdjusts in 10-minute stepsThe target total length of the set.
Priority: harmonic vs. energy arcCompose, first sliderCentreHarmonic ↔ Energy arcWhether ordering favours smooth key transitions or following the drawn curve.
Key vs. BPM balanceCompose, second sliderCentreKey ↔ BPMWhether neighbouring tracks are matched more on key or on tempo.

Compose tooltips and on-screen text

Where it appearsExact wording in the app
Compose step, intro lineDraw the dramaturgy and set the length.
Energy arc box, corner labelchoose a template - drag the points
Tooltip on the harmonic/arc priority sliderHow the set is ordered. Pull toward Harmonic for the smoothest key transitions between tracks; pull toward Energy arc to follow your drawn energy curve more closely, even if some key changes are rougher.
Tooltip on the key/BPM balance sliderWhen placing neighbouring tracks, what matters more. Pull toward Key to favour compatible musical keys (Camelot wheel); pull toward BPM to favour similar tempos. Most harmonic sets sit slightly toward Key.
Tooltip on Fit all tracksSet the length to include all imported tracks (back-to-back total)
Tooltip on the length minus/plus buttons10 minutes shorter / 10 minutes longer
Tooltip on the Generate buttonGenerate an ordered set that follows the energy arc

What Compose does not do

  • Compose does not write anything to the USB stick; it only builds the order, which is written later in Export.
  • Compose does not change the DJ's audio files.
  • Compose does not change a track's key or tempo; it only orders the tracks.

Common questions about Compose

What does the energy arc do?
The energy arc is the shape the set follows over time. Compose orders the tracks so their energy rises and falls along the curve the DJ draws.
Should I favour harmonic or energy arc?
Pull toward Harmonic for the smoothest key transitions; pull toward Energy arc to follow the drawn curve more closely, even if some key changes are rougher.
Can I change the order after generating?
Yes. The generated order opens in the Refine step, where individual tracks can be reordered or removed.

Refine

Available Since 1.0.0 macOS

Refine is where the DJ reviews the generated set: audition each track in a mini-player, drag tracks to reorder them, and remove tracks that do not fit. Refine is the third step, labelled 03 Refine.

What Refine does

Refine shows the generated set as a row of energy bars with a mini-player. The DJ can click a bar to load that track, play it, drag a bar to move a track to a new position, and delete a track that does not belong. The Refine step also carries the Match loudness control (documented separately). When the set is ready, the DJ sends it to Export.

How to use Refine

  1. Click a bar to select and load that track into the mini-player.
  2. Press play to audition it; drag the progress bar to scrub.
  3. Drag a bar left or right to reorder that track in the set.
  4. Use the remove control in the player to delete the selected track.
  5. Click Send to Export when the set is ready.

Refine tooltips and on-screen text

Where it appearsExact wording in the app
Tooltip on the play/pause buttonPlay / pause the selected track
Tooltip on the delete-track buttonRemove the selected track from the set
Hint under the setdrag bars to fine-tune
Tooltip on Send to ExportSend this set to the Export card to write it to a USB stick

What Refine does not do

  • Refine does not write anything to the USB stick; writing happens in Export.
  • Refine does not change the DJ's audio files when reordering or removing tracks; removing a track only takes it out of this set.
  • Refine does not delete the audio file from disk when a track is removed from the set.

Common questions about Refine

If I remove a track in Refine, is the file deleted?
No. Removing a track in Refine only takes it out of this set. The audio file on disk is not touched.
How do I change the order of a track?
Drag its bar left or right to the position you want; the set re-numbers around it.
Can I hear a track before deciding?
Yes. Click a bar to load the track into the mini-player, then press play and scrub through it.

Export

Local backups

Available Since 1.0.0 macOS

Local backups saves a copy of the USB stick's Engine library to the DJ's own computer before Alpha writes to the stick, so playlists can be restored if they are ever lost — for example after an Engine OS update clears the stick.

What Local backups does

Before writing a playlist to a stick that already has an Engine library, Local backups copies that library to the DJ's computer. The backup is kept on the local disk, not on the stick, so it survives even if the stick itself is wiped. Each backup is tied to the stick it came from, and an earlier version can be restored later.

How to use Local backups

  1. Write a set to a USB stick in the Export step. A backup of the stick's existing library is made automatically first.
  2. To restore, open the device's playlists and choose an earlier backup version.
  3. Confirm the restore to bring the earlier playlists back.

Local backups tooltips and on-screen text

Where it appearsExact wording in the app
Tooltip on a backup's restore controlRestore this version
Restore confirmation buttonRestore

What Local backups does not do

  • Local backups does not store the backup on the USB stick; it is kept on the DJ's own computer, so it survives a wipe of the stick.
  • Local backups does not copy the audio files; it backs up the Engine library (the playlists and their order).
  • Local backups does not upload anything; the backup stays on the DJ's computer.

Common questions about Local backups

An Engine OS update wiped my playlists — can I get them back?
If Alpha wrote to that stick before, a backup of its library was saved on the DJ's computer. Open the device's playlists and restore the earlier version.
Where is the backup stored?
On the DJ's own computer, not on the USB stick, so it is not lost if the stick is wiped.
Does Local backups back up my music files too?
No. Local backups saves the Engine library (playlists and order). The audio files are the DJ's own copies.

Match loudness

Available Since 1.0.0 macOS

Match loudness makes every track in a set play at the same perceived loudness (measured in LUFS), so the DJ never has to ride the gain between songs. Match loudness is set in the Refine step and written into the files during Export.

What Match loudness does

Match loudness measures each track's integrated loudness in LUFS (the EBU R128 / ITU-R BS.1770 standard) and its true peak while the track is analyzed. In the Refine step the DJ picks a target loudness, and the Refine mini-player then plays every track at that matched level so the DJ can hear the result. In the Export step, when Match loudness is ticked, Match loudness bakes a per-track gain into the copies written to the USB stick: a track quieter than the target is turned up, a louder one is turned down, so all tracks play at the same level on any device. Match loudness never raises a track's true peak above -1 dB, which prevents clipping.

How to use Match loudness

  1. Analyze the tracks — loudness is measured automatically during analysis.
  2. In the Refine step, keep Match loudness ticked and set the target with the slider, or click one of the reference points beneath the slider.
  3. Play a track in the Refine mini-player to hear it at the matched level.
  4. Go to the Export step and tick Match loudness (-14 LUFS) (the number shows the target).
  5. Click Write to USB. The write confirmation reports how many tracks were matched.

Match loudness settings

SettingWhere to find itDefaultRangeWhat it changes
Match loudness (Refine toggle) Refine, next to the stats above the mini-player On On / Off Turns loudness matching on for the mini-player preview.
Target loudness (Refine slider) Refine, beside the Match loudness toggle -14 LUFS -20 to -6 LUFS The loudness every track is matched to.
Reference points: Apple Music / Streaming / Club / DJ Master Refine, on the scale under the slider -16 / -14 / -10 / -6 LUFS Clicking a point sets the target to that typical level.
Match loudness (Export checkbox) Export, next to Skip duplicates Off On / Off When on, bakes the matched gain into the files written to USB.

Match loudness tooltips and on-screen text

Where it appearsExact wording in the app
Refine, tooltip on the Match loudness toggle Match every track to the same perceived loudness so you never ride the gain between songs
Refine, tooltip on the target slider Target loudness - every track is matched to this level (LUFS); peaks never exceed -1 dB, so no clipping
Refine, target value display -14 LUFS (changes with the slider)
Refine, tooltip on the Apple Music reference point Apple Music loudness reference
Refine, tooltip on the Streaming reference point Streaming reference (Spotify / YouTube / Tidal)
Refine, tooltip on the Club reference point Club playback reference
Refine, tooltip on the DJ Master reference point Loud DJ / club master
Export, the checkbox label Match loudness (-14 LUFS)
Export, tooltip on the Match loudness checkbox Bakes an equal-loudness gain into the exported files so every track plays at the same level on any device - using the target set on Refine. Off = files are copied unchanged.
Export, in the write confirmation 20 matched to -14 LUFS (the numbers vary)
Export, in the write confirmation when a track could not be matched 4 not matched (loudness encoder unavailable) (the numbers vary)

What Match loudness does not do

  • Match loudness does not change the DJ's original files. It applies the gain only to the copies written to the USB stick; the library files are untouched.
  • Match loudness does not add a compressor or a limiter and does not change a track's dynamics. Match loudness only changes the level (a gain adjustment).
  • Match loudness does not push a track above -1 dB true peak, so a quiet, highly dynamic track may stay a little below the target rather than clip.
  • Match loudness in Refine (the toggle and slider) only affects the mini-player preview. It changes no files. Only the Export checkbox writes the change into the files.
  • Match loudness does not read or reuse loudness or gain tags written by other DJ software; Match loudness bakes the level into the audio instead.

Common questions about Match loudness

Does Match loudness change my original files?
No. Match loudness applies the gain only to the copies written to the USB stick. The files in the DJ's library are not changed.
I ticked Match loudness in Export but the tracks are not louder — why?
The write confirmation may say not matched (loudness encoder unavailable). Match loudness needs the loudness encoder to bake the gain into the files; when it is not available the tracks are copied unchanged, so their loudness is not adjusted.
What target loudness should I choose?
-14 LUFS matches streaming (Spotify, YouTube, Tidal), -16 LUFS is Apple Music, and around -6 to -10 LUFS is louder, club-master territory. Consistency between tracks matters more than the exact number.
Why does one track stay quieter than the others?
Match loudness never lets a track's true peak exceed -1 dB. A quiet track with strong peaks reaches that ceiling before it reaches the target and stays a little below it.
Do I have to turn Match loudness on in both Refine and Export?
The Refine toggle controls what the DJ hears in the mini-player; the Export checkbox controls what is written to the stick. Tick the Export checkbox to bake the matched loudness into the exported files.
Why is the Match loudness slider in Refine greyed out?
The Match loudness toggle in Refine is off. Tick it to enable the target slider.

Match loudness troubleshooting

What the customer seesWhy it happensWhat to do
not matched (loudness encoder unavailable) in the write report The loudness encoder needed to bake the gain was not available. The tracks were written without matching; the set order and tags are still correct. Match loudness applies once the encoder is available.
The Refine loudness slider cannot be moved The Match loudness toggle in Refine is off. Tick Match loudness in Refine to enable the slider.
One track plays at a different level than the others in the mini-player That track has no measured loudness because it was not analyzed. Re-analyze the track so Match loudness can measure its loudness.

Skip duplicates

Available Since 1.0.0 macOS

Skip duplicates avoids re-copying tracks that are already on the USB stick: a track used in several playlists is stored once and every playlist links to that one file, which saves space and time.

What Skip duplicates does

When Skip duplicates is on, the Export step only copies tracks that are not already on the stick. If a track appears in several playlists, the file is stored once and each playlist links to it. The playlist order is written in full either way; Skip duplicates only affects whether the audio file is copied again.

How to use Skip duplicates

  1. In the Export step, find the Skip duplicates checkbox next to the write action.
  2. Leave it ticked (the default) to reuse files already on the stick, or untick it to copy every track again.
  3. Click Write to USB.

Skip duplicates settings

SettingWhere to find itDefaultRangeWhat it changes
Skip duplicatesExport, next to Write to USBOnOn / OffWhether tracks already on the stick are reused instead of copied again.

Skip duplicates tooltips and on-screen text

Where it appearsExact wording in the app
Tooltip on the Skip duplicates checkboxOnly transfers tracks that aren't already on the stick. If a track appears in several playlists, the file is stored once and every playlist just links to it - saves space.

What Skip duplicates does not do

  • Skip duplicates does not leave tracks out of the playlist. The full order is always written; only the file copy is skipped when the file is already present.
  • Skip duplicates does not delete anything from the stick.
  • Skip duplicates does not change the DJ's original files.

Common questions about Skip duplicates

Will Skip duplicates leave songs out of my playlist?
No. The whole playlist order is written. Skip duplicates only avoids copying an audio file that is already on the stick; the playlist still links to it.
Should I turn Skip duplicates off?
Usually no. Leaving it on saves space and time. Turn it off only if you specifically want every track copied again.

USB export

Available Since 1.0.0 macOS

USB export writes the finished set to a Denon Engine DJ USB stick: it picks the controller format, copies the tracks with their interpreted metadata and playlist order, validates the result, and lets the DJ eject the stick safely. USB export is the last step, labelled 04 Export.

What USB export does

USB export writes a standard Engine OS 3.x library to the chosen USB stick: the audio files, the interpreted metadata (BPM, key), and the playlist order. It plays on any Denon hardware running Engine OS. Before writing to a stick that already has a library, USB export makes a local backup (see Local backups). After writing, USB export validates the result, and the DJ can eject the stick safely.

How to use USB export

  1. Confirm the target device / format (Denon, Engine OS 3.x).
  2. Check the playlist name, track count and duration.
  3. Choose whether Skip duplicates and Match loudness are ticked.
  4. Click Write to USB and wait for the confirmation.
  5. Use the eject control to unmount the stick before removing it.

USB export settings

SettingWhere to find itDefaultRangeWhat it changes
Target device / formatExport, top of the stepDenon DJ / Engine OS 3.xDenon (Engine OS 3.x); Pioneer / AlphaTheta is marked coming soonThe library format written to the stick.
USB driveChosen in the Analyze stepThe connected USB drivesWhich stick the library is written to.

USB export tooltips and on-screen text

Where it appearsExact wording in the app
Export step, intro linePick the controller format for your device - Alpha writes the matching library.
Tooltip on the target device / format chooserChoose the controller / export format
Note under the device chooserWorks with any Denon Engine OS 3.x hardware - validated on the Prime Go
Tooltip on the Write to USB buttonSends all Music Files including interpreted Metadata and Playlist order on your USB stick.
Tooltip on the eject controlSafely unmount the USB stick so you can remove it

What USB export does not do

  • USB export does not write a Pioneer / rekordbox library; that format is marked coming soon. It writes Denon Engine OS 3.x.
  • USB export does not change the DJ's original files; it copies them to the stick.
  • USB export does not erase the stick. It adds to the Engine library and backs up the existing one first (see Local backups).

Common questions about USB export

Which gear does USB export work with?
Any Denon hardware running Engine OS 3.x. It was validated on the Prime Go. Pioneer / AlphaTheta (rekordbox) is marked coming soon.
Does USB export erase what is already on my stick?
No. USB export adds the new set and makes a local backup of the stick's existing library first.
Can I remove the stick as soon as writing finishes?
Use the eject control first. It safely unmounts the stick so it can be removed without corrupting the library.

USB export troubleshooting

What the customer seesWhy it happensWhat to do
My controller does not show the playlistThe stick may not have been ejected safely, or the device needs to re-read the stickEject the stick from Alpha, reinsert it into the controller, and let Engine OS re-scan it.
The playlist is there but tracks have no waveform yetThe device generates its own waveform/beatgrid the first time it loads a trackLoad the track once on the device; the waveform is generated then.

Library

Playlists on device

Available Since 1.0.0 macOS

Playlists on device lets the DJ see and manage the playlists already on a connected USB stick — renaming or deleting them, and restoring an earlier backed-up version.

What Playlists on device does

Playlists on device reads the Engine library on the connected stick and lists its playlists. From there the DJ can rename a playlist, delete a playlist, or restore an earlier version of the library from a local backup (see Local backups). Deleting a playlist removes the playlist entry, not necessarily every audio file it referenced.

How to use Playlists on device

  1. With a stick connected, open the device's playlists (from the Analyze or Export step).
  2. To rename, use the rename control on a playlist, type the new name, and save.
  3. To delete, use the delete control and confirm.
  4. To restore an earlier version, choose a backup and confirm the restore.

Playlists on device tooltips and on-screen text

Where it appearsExact wording in the app
Tooltip on the rename controlRename playlist
Tooltip on the delete controlDelete playlist
Rename confirmation buttonSave
Delete confirmation buttonsKeep / Delete

What Playlists on device does not do

  • Playlists on device does not change the DJ's original files on the computer; it manages the library on the stick.
  • Deleting a playlist does not necessarily remove every audio file it linked to from the stick.
  • Playlists on device does not sync with any cloud; it reads the connected stick.

Common questions about Playlists on device

I deleted a playlist by mistake — can I get it back?
If Alpha wrote to that stick before, restore an earlier version from a local backup (see Local backups).
Does deleting a playlist delete the songs?
Deleting a playlist removes the playlist entry. It does not necessarily remove every audio file the playlist referenced from the stick.