ABYZOR KEYS — User Manual

1. Introduction

ABYZOR Keys is a DJ library preparation tool. It analyzes your music files to detect musical key, BPM, energy, and structural cues, then helps you search, filter, match harmonically, and build playlists or full sets.

First launch

1. Open ABYZOR Keys.
2. On the Home screen, click Choose folder (or use Import → Import Folder in the top bar).
3. Select a folder containing audio files (MP3, WAV, FLAC, AIFF, M4A, AAC).
4. Tracks are imported and analyzed in the background. You can browse the Library while analysis runs.
5. After a large import, you may see How should we analyze your library? — choose a speed preset (light vs fast).

Key concepts

System requirements

Supported platforms

• Windows: Windows 10 or later (64-bit)
• macOS: macOS 12 Monterey or later (Intel or Apple Silicon)
• Portable zip — no Python install required

Minimum

• CPU: Dual-core processor (64-bit)
• RAM: 4 GB
• Storage: ~500 MB for the app + extra space for your music library and local cache (waveforms, artwork, database)
• Display: 1280×720 or higher
• Audio: Standard speakers or headphones for preview
• Internet: Optional (updates, license activation, Pro purchase on abyzor.space). Key/BPM analysis works fully offline.

Recommended

• CPU: Quad-core processor or better
• RAM: 8 GB or more (smoother batch imports and background analysis)
• Storage: SSD
• Display: 1920×1080 or higher

Performance notes

• Typical analysis: ~10 seconds per track (varies with file length and settings)
• Large libraries (1,000+ tracks): first import can take a while; use Settings → Analysis → “Keep PC usable” if you want to use the PC while analyzing
• Your audio files stay on your drive — ABYZOR Keys does not upload your library

2. Global Navigation

The app shell has four persistent areas: sidebar, top bar, main workspace, and status bar. The inspector appears on the right in Playlist and Smart Set Builder only.

Sidebar

Shortcuts: Ctrl+1 … Ctrl+6 jump to Home, Library, Playlist, Smart Set Builder, Statistics, and Settings.

Top bar

Status bar

Shows tracks analyzed (done / total), analysis progress, CPU usage, and cache size.

Inspector panel

• Visible in Playlist and Smart Set Builder workspaces.
• Press Tab to show or hide the inspector.
• Playlist (manual): track artwork, metadata, tags, notes, favorite, rating, preview, and Add to Playlist — same detail panel as Library (LibraryInspectorLite). No Mix Coach or Transition Audition.
• Smart Set Builder: Mix Coach (Pro) and Transition Audition (Pro) in the Smart Inspector, plus transition context for the selected row.

Command palette

Press Ctrl+K to open the command palette. Type a command name or search tracks. Use ↑↓ to navigate, Enter to run, Esc to close.

3. Home

The Home screen is your landing page after launch.

Empty library

If no tracks are imported, you see an empty state with:

• Import Folder — pick a music folder
• Import Files — pick individual audio files
• Drag-and-drop support for folders and files

Dashboard (library has tracks)

4. Library

The Library is the main workspace for browsing, filtering, previewing, and managing tracks. The Harmonic Explorer is built into Library — there is no separate sidebar item for it.

Layout

Three columns:

1. Left — Smart Collections — Built-in and custom filtered views.
2. Center — Track list — Search, filters, preview panel, table or grid view.
3. Right — Harmonic Explorer + Inspector Lite — Circle of Fifths or compatibility matrix, match cards, and per-track metadata editor.

Smart Collections

Built-in collections include Recent, Favorites, Peak Time, Warmup, Closing, and Experimental.

• Click a collection to filter the track list.
• New Smart Collection… opens the rule editor.
• Right-click a custom collection to Edit or Delete.
• After applying filters manually, use Save as Smart Collection to persist them.

Search and filters

Search bar supports plain text and grammar tokens, for example:

• bpm:120 — BPM around 120
• key:Am — tracks in A minor
• artist:aretha — artist name

Filter chips add structured filters: Key, BPM, Energy, Genre, Rating, Status, Confidence, Harmonic compatibility, and Tags. Use + Add filter or Clear all.

Toggle between List and Grid view.

Track preview

Select a track to open the preview panel at the top:

• Waveform with cue markers
• Play / pause preview (Space)
• Jump to cues 1–8 when preview is focused (keys 1–8)
• BPM, key, energy, vocals, spectral balance, mix points (Mix In, Drop, Mix Out)

Harmonic Explorer

With a track selected that has a detected key:

• Circle view — compatible keys on the circle of fifths
• Matrix view — grid of key-to-key compatibility scores
• Composite score toggle — include BPM and energy in scores, or key harmony only
• Click a matrix cell to filter the library to compatible tracks
• Match cards list recommended next tracks (Pro upsell on free tier for advanced suggestions)

Bulk actions

Select multiple tracks to show the bulk bar:

• Add to Playlist
• Compare tracks (opens Quick Compare with two tracks)
• Clear selection
• Select all (Ctrl+A)

Right-click context menu

Inspector Lite (right column)

Edit per-track metadata without leaving Library:

• Star rating (0–5)
• Favorite toggle (F)
• Tags (T)
• Notes
• Cue list and structural fields

5. Playlist

Playlist is the manual playlist builder. It is always free.

Build and order tracks manually — key and BPM at a glance.

Pro teasers

At the top of the workspace, upsell cards may appear for Generate Set and Mix Coach. These features run in Smart Set Builder (Pro), not in the manual playlist builder.

Playlist management

• Dropdown to select the active playlist
• New, Rename, and Delete playlist
• Track count shown in the header

Building a playlist

1. Search tracks in Search tracks to add… and click Add.
2. Or add selected tracks from Library (Ctrl+P, context menu, or bulk bar).
3. Each row shows artwork thumbnail, title, artist, BPM badge, key badge, and duration.
4. Drag rows to reorder.
5. Remove tracks with the × button on each row.

Set stats

When the playlist has tracks, a stats line shows average BPM, average energy, and raw vs mixed duration (minutes).

Inspector

The right-hand inspector shows full track detail for the selected row (metadata, tags, notes, preview). Press Tab to toggle visibility. Mix Coach and Transition Audition are not available here — use Smart Set Builder for those.

Export

Click Export in the playlist builder or use Export → Export Playlist in the top bar. M3U / M3U8 / CSV are free; DJ ecosystem formats require Pro. See Export dialogs.

6. Smart Set Builder

Smart Set Builder generates DJ sets with harmonic ordering and an energy arc. This is a Pro feature; free users see a preview teaser and upgrade CTA.

Harmonic order + energy arc — the mix no one else builds for you.

Set configuration

Generate workflow

1. Configure source, template, and duration.
2. Click Generate Set (or Generate).
3. In the Generate set dialog, choose:
   • Playlist mode: New playlist, Regenerate current, or Continue current
   • Generation quality:
     • Fast — under 1 second, greedy pass
     • Smart (Recommended) — beam search, ~2–5 seconds
     • Deep Search — explores 30 arrangements, ~30 seconds
4. A Preview — not saved bar appears with the generated order.
5. Click Accept to save or Discard to cancel.

After generation (Pro)

Views

Transition hints

Between rows, ABYZOR shows Suggested next transition hints based on harmonic and BPM compatibility. Boundary bars between tracks can show Mix Coach transition warnings (Pro); click a boundary to select it for audition.

Row controls

• Pin track (anchor) — locked rows are not moved by the optimizer
• Alternatives — swap a row for a harmonically similar track
• Transition score — tap to see alternative tracks for that slot

Smart Inspector (right panel)

7. Statistics

The Statistics workspace shows library health, KPIs, charts, and insights.

Free tier

• Basic KPI cards (limited set)
• Pro teaser preview for full analytics

Pro tier

Click Library Health items to navigate directly to affected tracks in Library.

8. Settings

Open Settings from the sidebar or top bar. Changes are not saved until you click Save Settings at the bottom.

General

• Startup workspace — which screen opens when you launch the app

Analysis

Audio

Metadata

• Create backup before writing tags — safety copy before overwriting file tags

Library

Harmonic

• Key notation — default display notation
• Composite score default — whether matrix scores include BPM/energy by default

Appearance

• Color blind mode — accessible color palette
• Reduced motion — fewer animations

Shortcuts

Editable table of keyboard shortcuts. Click Change… to capture a new key, Reset per row, or Reset all to defaults.

License

• Enter license key to activate ABYZOR Keys Pro
• Offline activation with machine code
• Activate button in the sidebar also opens this section

About

• App version and release channel
• Check for updates

Advanced

• Analysis workers override (0 = automatic)
• Developer reset options (use with care)

9. Dialogs and Wizards

Import

First Import Hint

Opens: Automatically on your first folder import.

Purpose: Suggests starting with a manageable folder size.

Analysis Preset (after large import)

Opens: After importing many tracks at once.

Purpose: Choose how aggressively to use CPU during analysis.

You can close the app during analysis — it resumes where it left off.

Import Library Metadata

Opens: Settings → Library → Import library metadata…

Purpose: Import playlists, ratings, and cues from another DJ library.

Options: Add tracks on disk not yet in ABYZOR; overwrite existing metadata from import; import cue points.

Click Browse… to select the file or folder, review the preview summary, then Import.

Export

Export Playlist / Export Library

Opens: Top bar Export menu, or Export button in Playlist / Smart Set Builder.

Purpose: Choose an export format.

DJ software formats (Pro for full ecosystem exports):

Universal formats (free):

Select a format card and click Continue, then choose the save location.

Prepare USB

Opens: Export menu → Prepare USB

Purpose: Copy audio and playlists to a USB stick for DJ hardware.

Click Preview to see space requirements and warnings, then Prepare USB.

Library maintenance

Review Queue

Opens: Home or Statistics review banner, or Review button.

Purpose: Review tracks with low key or BPM confidence, one at a time.

Audio preview is available per track. Summary shown when the queue is empty.

Write Tags

Opens: Tools → Write Tags…, or track context menu → Write Metadata.

Purpose: Write ABYZOR's analyzed key and BPM into file tags for other DJ software.

Select tracks, review status (In sync, Ready to write, etc.), click Write selected.

Relink Missing Files

Opens: Settings → Relink missing files…, or context menu on missing tracks.

1. Click Browse folder… and select a search root.
2. Click Scan folder to find matches (filename + size, or partial hash).
3. Select rows and click Relink selected.

Find Duplicates

Opens: Settings → Find duplicates…

1. Click Scan library.
2. Review groups (Exact copy, Same artist/title).
3. Merge & remove, Keep both, or Merge all suggested.

Tag Manager

Opens: Settings → Manage tags…

Rename, merge into another tag, or delete tags. Track assignments update accordingly.

Smart Collection Editor

Opens: Smart Collections → New Smart Collection… or Edit.

Set a name and build rules (AND/OR groups). Live count shows matching tracks. Save to persist.

Playlist tools

Add to Playlist (picker)

Opens: Add to Playlist from Library bulk bar, context menu, or inspector.

Pick an existing playlist or create a new one. Supports adding multiple tracks at once.

Quick Compare

Opens: Library → Compare tracks (two tracks selected) or context menu → Compare Track.

Side-by-side comparison: transition score, keys, BPM, energy, harmonic distance.

System

Command Palette

Shortcut: Ctrl+K

Search commands (navigation, import, export) or tracks. Categories: Navigation, Library, Export.

Keyboard Shortcuts Cheatsheet

Shortcut: ?

Read-only list of all shortcuts by scope.

Update Available

Opens: Automatically when a new version is detected.

Download the update, remind later, or skip this version.

Pro Upgrade

Opens: When tapping a locked Pro feature.

Shows Pro benefits and upgrade CTA. Activate a license in Settings → License instead.

10. Background Analysis

After import, ABYZOR analyzes tracks in two phases:

1. Keys & BPM (quick scan) — makes tracks usable in Library and playlists.
2. Enrichment (background) — adds vocals, structure, mix points, and extra metadata.

What you can do during analysis

• Browse and filter tracks as they become ready.
• Pause analysis from the top bar (Pause analysis).
• Resume with Resume analysis.
• Close the app — the queue resumes on next launch.

Status meanings

The status bar shows overall progress (Analyzing X · Waiting Y · Done Z).

11. Free vs Pro

ABYZOR Keys has a free tier for library management and manual playlists. Pro unlocks AI set building, advanced analytics, and ecosystem exports.

Activate Pro in Settings → License or via the sidebar Activate button.

12. Keyboard Shortcuts

Default shortcuts. Customize in Settings → Shortcuts.

Global

Library

Preview (when preview panel is focused)

Playlist (manual)

Smart Set Builder

Installation & Support

Document version: matches ABYZOR Keys UI strings as of 2026-07. For technical validation and release gates, see docs/LAUNCH_GATE_RESULTS.md.
© 2026 ABYZOR Audio · ABYZOR Keys User Manual