1. Introduction
APU Harmonic DJ analyzes a local music library and helps turn it into directed transitions and complete tracklists. It combines key and BPM detection with modal relationships, full harmonic evidence, gain guidance, and the transitions you personally save as Gems.
The basic workflow is simple: add music to the Library, create or generate a Mix, audition the transitions that matter, and save the strongest directed pairings as Gems. Harmonic DJ can do the routine searching while leaving the final musical decision where it belongs: with the listener.
Harmonic DJ is local-first. Audio analysis and audition happen on your computer. Shared collections contain path-free metadata and analysis rather than commercial audio, and a Mix document does not contain the audio files referenced by its tracklist.
Start with Getting Started for a first tracklist using the release defaults. The later sections explain how to refine a Mix, use Gem Finder, create custom transition profiles, and exchange metadata with another Harmonic DJ user.
2. Getting Started
A first useful result does not require any theory or custom configuration. Add a representative folder, let its tracks finish analyzing, and generate a Tracklist Preview with the defaults. This gives us something musical to react to before changing the rules.
2.1. Install and Launch
The initial Harmonic DJ release is a standalone application for Windows, macOS, and Linux; plug-in formats are not included. Install the application using the package for your platform, then open APU Harmonic DJ from the normal applications location.
The application starts in Community unless a Pro trial or paid license is active. Community does not require an account or activation. Open About when you want to start a Pro trial or activate an existing license. Visit the APU Harmonic DJ product page to see current Pro pricing or purchase Pro.
On Windows N and KN editions, Harmonic DJ requires the Microsoft Media Feature Pack. The installer checks for the underlying Media Foundation components and can open Windows Optional Features when they are missing.
2.2. Create Your First Library
- Open the Library workspace.
- Choose Add Folder and select a folder containing music, or use Add Files for a smaller first pass.
- Leave Harmonic DJ open while it discovers and analyzes the supported files.
- Use the Ready to mix filter when you only want to see tracks with completed key and BPM analysis.
- Select a track and use the playback control to audition it.
Analysis can run across several tracks at once. The Library remains usable while work continues, and completed results survive cancellation. If a scan is interrupted, Harmonic DJ resumes the durable queue the next time the application opens.
A few dozen stylistically related tracks within a compatible BPM range are enough to learn the default workflow. Tracks spread across unrelated tempo ranges may not form a complete route with the default General Purpose profile and Same Mix BPM rule. Use Gem Finder to investigate individual pairs, or add more tracks near the BPM range you want to mix.
2.3. Create Your First Tracklist Preview
- Open Mix.
- Leave Tracks at five and BPM on Auto.
- Open Settings and confirm the release defaults: Benchmark-Guided Modal, Start / end keys, Prefer same start / end, General Purpose, Same Mix BPM, Auto search quality, and harmonic detail enabled.
- Return to the tracklist and choose Generate Mix.
- Audition the result. Lock anything you want to keep, replace an alternative, or exclude a poor fit, then generate again.
Community provides the complete temporary Tracklist Preview workflow with up to five tracks. Pro adds named Mix documents, exact track counts above five, arbitrary placement, Gem Finder, and saved Gems.
The generated route is a starting point, not a claim that every transition is ready to perform unchanged. Rhythm, phrasing, energy, cue points, and transition treatment still need musical judgment.
3. Library
The Library is the analyzed source collection used by Mix, Gem Finder, and saved Gems. It keeps local file locations, track metadata, analysis results, groups, and track status in one local database. Removing a Library entry does not delete its audio file.
3.1. Adding and Analyzing Audio
Use Add Files, Add Folder, or drag supported audio into Harmonic DJ. Folder discovery includes supported files beneath the selected folder and adds them to a durable analysis queue.
One analysis pass collects file and tag metadata, BPM, integrated loudness, level information for gain matching, and harmonic evidence for every selectable key contour. Because the underlying evidence is retained, changing the active contour or reference SPL does not decode the audio again.
Cancel asks the active discovery, library operation, or analysis queue to stop cooperatively. The track currently being analyzed may restart later, while already completed tracks remain available.
The file chooser advertises the formats supported by the current platform. These normally include common WAV, AIFF, FLAC, Ogg Vorbis, and MP3 files. AAC and ALAC in M4A containers use Media Foundation on Windows and Core Audio on macOS, so M4A is only advertised where that native decoder is available.
3.2. Browsing and Auditioning
Search matches file information, identity metadata, and detected key labels. Click a column heading to sort, and use the filter beside the search field to focus on:
- All tracks
- Ready to mix
- Excluded from mix
- Needs attention
- Missing files
- Favorites (4-5 stars)
Select a local track to audition it. The transport at the bottom of the application is shared across Library, Mix, Gems, and Gem Finder, so playback continues to feel like one listening session while you move between workspaces.
Imported collection tracks can participate in metadata-only planning but do not have local audio. Harmonic DJ identifies them as shared tracks instead of presenting them as broken local files.
The sortable Rating column shows your private 1-5 star preference. Click a star to rate one track, click its current rating again to clear it, or use Personal Rating in the track menu to rate the complete selection.
Right-click a track for actions such as Add to Mix, Personal Rating, Move to Group, Find Online, Show in Folder, Rescan, and Remove from Library. Adding to Mix inserts after the selected Mix track, or appends when no Mix position is selected.
3.3. Personal Track Ratings
Track ratings express how much you want a song to recur in your own mixes. 5 stars means you love it, 4 stars marks another favorite, 3 stars and Unrated are neutral, and 1-2 stars ask Harmonic DJ to use the track less often without excluding it.
Ratings are a soft preference after the hard musical and Mix rules. They can choose a favorite when otherwise-eligible routes are close, and they refine same-key alternatives and Gem Finder ordering. They never override exclusions, Allowed Keys, BPM requirements, transition-rule priority, a stronger saved-Gem rating, or any other eligibility constraint.
Ratings are available in both Community and Pro. Local and imported shared tracks can both be rated, and their rating is visible read-only in Mix and Gem Finder. The preference survives rescanning and later reimport of the same track path. A byte-identical moved file also keeps its rating when Harmonic DJ can relink it as described in Library Maintenance.
Ratings are private. Your path-based Library Metadata backup includes them, but shared collections and published Mix pages do not. A recipient can assign an independent rating to a shared track after import.
3.4. Key Profiles and Key Guide
The contour and reference-SPL controls choose the active key profile. That choice belongs to the active Mix and is used consistently by Library, Mix, Gems, and Gem Finder.
ECMA-418 is the release default. None uses calibrated-flat evidence. ISO 226:2003 and ISO 226:2023 are phon-dependent profiles, so their result also depends on the selected reference SPL. Switching between these profiles is immediate because the scan already retained the required harmonic evidence.
Open Key Guide from a detected key to compare major/minor character or the six supported advanced modes across all twelve tonic roots. The guide can preview matching local Library tracks and add or replace a Mix track. It is an exploration surface, not a second analysis mode.
3.5. Library Groups
Library groups are local organizational labels. Use the group selector to show All Groups, Ungrouped, one local group, or a group inside an imported shared collection.
Choose Library → Manage Groups to create, rename, reorder, or delete local groups. Deleting a group keeps its tracks and returns them to Ungrouped. Select one or more local tracks and use Move to Group to change their membership.
The Library group selector only changes what is visible in the Library. The group selector in Mix independently chooses which groups can supply tracks during generation, and that selection is saved with the Mix.
3.6. Library Maintenance
Rescan analyzes the selected local tracks again. Use it after replacing an audio file, after a prior analysis error, or when a future detector revision specifically requires new analysis.
When a local file has moved and its old path no longer exists, add the byte-identical file from its new location. Harmonic DJ compares a SHA-256 hash of the complete file with missing Library records. One unambiguous match keeps the track’s stable identity, earlier analysis while reanalysis runs, group, personal rating, and directed Gems. The open Mix replaces the old path and auto-saves; other saved Mixes keep working through the old-path alias and replace it when you open them. This works when the move happened while Harmonic DJ was closed because the missing Library record remains available as the matching anchor.
Matching is deliberately conservative. If the old file still exists, the second path is treated as a separate copy. If several missing records have identical content, Harmonic DJ does not guess which one moved. Editing tags, transcoding, or otherwise changing any file bytes creates a different hash and therefore does not auto-link.
Pending discovery records file metadata without reading track contents. When a worker starts a track, it reads the complete file to establish its content identity, immediately analyzes the audio, then reads the complete file again to record the final identity. Each worker therefore performs hash, analysis, and final hash in per-track sequence instead of hashing a whole import before analysis. Ordinary browsing, opening saved Mixes, and application startup do not rescan file contents.
Remove from Library removes the selected local records without deleting audio. Personal ratings and saved directed Gems keep their old path context, so they reconnect if that same path is added again later. Removing the record also removes the content-matching anchor; add a moved file first if you want automatic relinking.
Remove Missing Files searches the local Library for paths that no longer exist and asks before removing those records. Re-add moved files from their new location before using this cleanup so Harmonic DJ can recognize them. Shared collection tracks are not treated as missing because they intentionally have no local path.
Export Library Metadata writes a local JSON backup containing file paths, analysis state, and personal ratings. Import Library Metadata restores that path-based metadata on a compatible system. Use Shared Collections instead when sending analysis to another person.
4. Mix
A Mix combines a tracklist with the exact planning choices used to create it. The track order, locks, exclusions, target track count, BPM, group scope, key profile, transition profile, loudness target, and other Mix Settings travel together.
Harmonic DJ ranks complete routes by improving the weakest accepted transition first. This keeps several strong transitions from averaging away one poor connection. Your personal track ratings then provide a bounded preference among eligible choices without weakening the Mix constraints.
4.1. Mix Documents
Pro Mixes are named, auto-saved documents. Use the Mix browser to search and switch documents, + to start a blank Mix, and the … menu to duplicate, rename, delete, import, or export.
New Mix keeps the active target track count and starts from factory planning settings with an empty tracklist. Duplicate Mix preserves the complete current document. Switching Mixes restores each document’s own tracklist and strategy.
Undo and redo store complete, user-named document revisions. They remain available after a clean relaunch, and a new change after undo replaces the redo branch in the usual way.
Community uses one temporary Tracklist Preview rather than creating named documents. Existing Pro Mixes remain readable and auditionable when Pro is inactive, but Pro-only editing actions stay disabled.
4.2. Building a Tracklist
Set Tracks to the exact number of positions you want, choose a Mix BPM or leave it on Auto, select the Library groups that may supply tracks, then choose Generate Mix.
Auto BPM follows the marked intro track, falls back to the first track, or lets the first generated track establish the target for an empty Mix. A typed value fixes the Mix target between 40 and 300 BPM.
You can also build manually. Select ready tracks in Library and use Add to Mix, or drag local track rows out to a DAW. Manually extending a tracklist beyond the current target automatically raises the target so authored positions are not discarded.
Mark one track as the intro or closer when that role matters. Those roles constrain the corresponding position during later generation without turning musical duration into a route-length estimate.
4.3. Refining a Tracklist
Select or right-click Mix rows to refine a result:
- Lock preserves authored positions during generation.
- Replace with Another Track steps through compatible alternatives for one position.
- Regenerate This Segment searches the unlocked region around the selected position while keeping its locked boundaries.
- Remove Without Excluding removes a track but allows it to return later.
- Exclude from This Position, This Segment, or Entire Mix records where the track should not return.
- Exclusions reviews and removes those rules without changing the current tracklist.
Explicitly locked tracks remain authored choices even if a later settings change would not select them automatically. New generated positions still have to satisfy the current constraints.
Same-key alternatives put higher-rated tracks first. A compact star badge in the tracklist shows the current personal rating without turning it into Mix document state.
Each incoming transition keeps the explanation and settings context captured when that exact directed pair was authored. Changing the transition profile, key profile, key-matching scope, or BPM strategy therefore does not relabel earlier work. Hover a Mix row to review its origin and original context; if the current settings evaluate it differently, that comparison remains secondary tooltip detail. Replacing either endpoint creates a new edge, while moving an intact locked sequence keeps its existing explanations.
Clear removes the current tracklist, locks, and exclusions. It keeps the Mix name, target track count, planning settings, and audio Library.
4.4. Audition and Gain Guidance
Each analyzed Mix row shows a signed track-gain recommendation. This matches the track to a fixed ECMA-based reference and does not change when other tracks are added or removed. That stability makes it practical to copy the individual values into a DAW.
The Active Mix target sets the desired integrated loudness for the complete Mix. Harmonic DJ calculates one common pre-limiter gain from the gain-adjusted track average. Changing the target or tracklist changes this common value without rewriting the individual track recommendations.
Harmonic DJ applies both values during audition so playback follows the active Mix target. It does not write processed audio, add a limiter, or make transition-treatment decisions for you.
Track gain is post-planning advice. It never changes whether a route or transition is accepted.
4.5. Share Mix
Share Mix prepares listener-facing details without changing the working tracklist. Enter a public Mix title and optional DJ or creator byline, then review the artist and title selected for each track.
Track display names start with embedded tags and fall back to conservative filename parsing. Corrections made here belong to this Mix only; they do not rewrite the audio file or global Library metadata.
Copy Tracklist copies the exact plaintext preview, including the Mix title, creator, ordered tracks, and appropriate link. Before publication the footer points to Harmonic DJ; once the current snapshot is published, it points to that Mix’s permanent page. This workflow does not upload audio.
Copied and published transition explanations come from the settings that authored each edge, not whichever profile is currently selected. A tracklist completed under several transition profiles is labeled Iterative and names them; private current-settings comparisons are not published.
5. Mix Settings
Mix Settings contains the planning rules saved with the active Mix. The example above uses Chroma-Driven Modal; detector choice belongs to the Mix, so another Mix can still use Benchmark-Guided Modal. Reset Mix Settings returns the whole page to the release defaults: Benchmark-Guided Modal detection, ECMA-418, the General Purpose transition preset, start/end matching, a preference for stable tracks, Same Mix BPM, Auto search quality, and harmonic-detail ranking.
Change one idea at a time and listen to complete Mixes. A focused transition preset is much easier to understand when the other constraints remain steady.
5.1. Transition Profiles and Presets
A transition profile is the ordered set of enabled relation rules used to accept directed harmonic edges. The first enabled rule that matches a transition supplies its priority and primary explanation.
General Purpose enables the four broad release rules in priority order: Parallel Intervals, Steady Harmony, Parallel Progression, and Steady Progression. The factory catalog also includes a focused preset for each of those relationships plus Steady Brightening and Parallel Brightening.
Applying a preset copies its complete profile into the active Mix. The Mix keeps that snapshot, so later edits or deletion of a user preset cannot silently rewrite an older Mix.
Factory presets are immutable. Pro users can save the active profile as a user preset, then update, rename, describe, import, export, or delete that reusable entry.
5.2. Relation Rules and Rule Builder
Each relation rule describes one or more accepted source-to-destination relationships. A rule can constrain source and destination modes, source and destination tonics, or a destination tonic movement relative to the source.
Use Add for a new rule, Edit to open Rule Builder, Enable/Disable to change the selected rules, and drag rows to set priority. Reset restores General Purpose. Duplicate and delete remain under More.
Rule Builder expresses alternatives rather than a hidden script. Common relationships take one alternative, for example, the same mode with a destination root five semitones higher. More specific ideas can enumerate modes or tonics, use steps from the source mode, or combine several alternatives inside one named rule.
Saving the rule applies its complete current definition to the Mix. Canceling a changed form asks before discarding edits. At least one relation rule must remain enabled so the profile always has a usable harmonic meaning.
5.3. Key Detection and Matching
Benchmark-Guided Modal is the default detector projection and supports Ionian, Dorian, Phrygian, Lydian, Mixolydian, and Aeolian. Benchmark Major / Minor provides a conventional two-mode view. Chroma-Driven Modal retains the earlier modal projection for comparison.
Start / end keys compares the detected second half of the source track with the first half of the destination. This is the default because a transition is directional: the outgoing part of one track meets the incoming part of another.
Whole-track key combines both analyzed halves in proportion to their duration, detects one key, and uses it at both boundaries. When whole-track matching is active, the separate start/end relationship control is not used.
With start/end matching, the relationship control can require, prefer, ignore, discourage, or require a key change within each track. Preferences are soft tie-breakers after transition quality; requirements filter newly selected tracks.
5.4. Allowed Keys
Allowed Keys filters roots and modes independently across the complete Mix. Every root and every supported mode is enabled by default.
A track is eligible only when both its effective start key and effective end key use an enabled root and mode. With pitch-shifted playback, the effective keys include the same target-relative semitone shift used for audition.
These are global membership constraints, not transition rules. Locked positions, Gem Finder placements, and saved Gems cannot bypass them. At least one root and one mode must remain enabled.
5.5. BPM Constraints
Same Mix BPM accepts tracks whose detected BPM rounds to the Mix target. Playback remains native at a 1:1 rate.
Allow pitch-shifted tracks keeps those native matches and adds tracks whose target-relative playback ratio is within five cents of a nonzero integer-semitone shift inside the selected range. Those tracks play at the Mix BPM, and their keys move by the same integer number of semitones before Allowed Keys and transition matching are evaluated.
Ignore BPM leaves every track at its native playback rate and does not use BPM as a planning constraint.
Harmonic DJ intentionally does not contain a pitch-preserving time-stretch engine. When pitch-shifted tracks are allowed, speed and pitch move together as they would on a variable-speed deck.
5.6. Search Quality and Harmonic Detail
Auto quickly supplies a good complete route, proves the best route when the remaining search is manageable, and otherwise continues as a bounded anytime search. The result reports whether it was proven optimal or was the best route found within that budget.
Optimal uses the same ordering and pruning but continues until the best route is proven or you cancel. It is most useful for a constrained Library or a final comparison where additional search time is acceptable.
Harmonic detail reranks already accepted transitions using the fuller outgoing and incoming harmonic distributions. It does not make an otherwise rejected transition legal and is not presented as a probability that two songs will mix well.
Route comparison sorts transition quality from weakest to strongest. Harmonic DJ improves the weakest transition first, then the next weakest. Personal ratings contribute only a bounded preference below transition-rule and saved-Gem rating steps; track-level preferences, analysis confidence, and preservation of the current slot resolve the remaining ties.
6. Gem Finder and Saved Gems
Automatic generation searches a broad relationship. Gem Finder starts from one outgoing track and lets us ask a much more specific musical question. Saved Gems preserve the directed answers that remain useful after listening.
6.1. Finding a Next Gem
Select a Mix track and choose Find Next Gem from its context menu. The same action appears after the final track, where it naturally means “find something that could follow this.” Gem Finder requires Pro and a usable outgoing key for the selected track.
The circle of fifths marks the Mix track’s outgoing parent key separately from the incoming parent key you are exploring. Choose an incoming parent key and one of the six supported modes to define an exact modal key. The piano shows the tonic seventh chord associated with that selection.
Play Chord sustains those pitches while you alternate between the Mix track and candidate tracks. The chord is a harmonic probe: it helps teach the selected color without pretending that Harmonic DJ knows the correct cue point, phrase alignment, or transition treatment.
6.2. Candidate Selection and Placement
The first query requires the exact selected root and mode. Fewer broadens the search to same-root analyzed modes that contain the complete chord, then removes one non-root chord tone at a time. More reverses those steps and eventually restores exact root-and-mode matching.
Potential Gems include unused Library tracks that satisfy the active Mix BPM rule, Allowed Keys, matching scope, and start/end relationship requirement. Mix groups and exclusions do not hide Gem Finder candidates; this keeps the ear-led search broader than automatic generation.
Exact selected-key realizations rank first. Within otherwise-close results, higher personal ratings surface earlier and each rated row shows its star count. For relaxed results, selecting a candidate updates the displayed incoming mode while keeping the chord root and currently required pitches intact.
Place the candidate after the source track, or replace the existing next track. Placement locks the directed pair and records its local harmonic approval for that Mix. It does not save a Gem, approve the reverse direction, or relax BPM and Allowed Keys.
6.3. Saving and Rating Gems
After placing and auditioning a strong pair, right-click the destination Mix row and choose Save Incoming Transition as Gem. The saved direction is the preceding source track into that destination track.
A Gem explicitly authorizes that exact directed harmonic edge even when the general transition profile would reject it. BPM, Allowed Keys, uniqueness, and other non-harmonic constraints still apply. Saving source → destination never implies destination → source.
Gem ratings use the same 1-5 star language as track ratings. Click a star to set the personal rating, click the current star again to clear it, or choose Unrated from Personal Rating. A higher rating may increase preference between otherwise feasible choices, but it remains separate from detector evidence.
6.4. Browsing and Reusing Gems
The GEMS workspace groups destinations beneath each source track. Select a destination to inspect and manage the saved directed pair.
Pro can append the pair to Mix, insert it after the selected Mix track, or replace the complete Mix tracklist with the pair. Both tracks must still be available and satisfy the active Mix BPM and Allowed Keys.
Local rows can be dragged to a DAW. Show Track in Library and Show Track in Folder reconnect the saved evidence with its audio. Removing one Gem or clearing the complete collection never deletes audio, Library tracks, or Mix tracklists.
7. Concepts and Theory
Harmonic DJ exposes enough theory to explain and shape a result, but the theory is not the result. A detected relationship can make a pairing worth hearing; rhythm, phrasing, energy, arrangement, and taste still decide whether it becomes a useful transition.
7.1. Keys, Modes, and Parent Keys
A key label combines a tonic root with a mode. Benchmark-Guided Modal currently uses Ionian, Dorian, Phrygian, Lydian, Mixolydian, and Aeolian. Locrian completes the traditional seven-mode pattern, but it is not part of detector-dependent planning in the initial release.
Each modal key can also be viewed through its parent Ionian pitch collection. Two modal keys may share a parent collection while emphasizing different tonics, or preserve one modal tonic while moving between parent collections. This is why one major/minor or Camelot-style label cannot describe every relationship Harmonic DJ can express.
The guide below holds the pitch collection fixed to C major’s white keys and moves only the tonic. Start on the highlighted key, continue across the white keys, wrap at C when needed, and stop when the tonic returns an octave higher: C to C is Ionian, D to D is Dorian, and so on.
The circle of fifths in Gem Finder shows parent keys because it gives us a stable way to explore pitch collections while separately choosing the destination mode and modal tonic.
7.2. Incoming and Outgoing Evidence
Harmonic DJ analyzes the first and second complete halves of each track. In the default start/end matching scope, the first half supplies incoming evidence and the second half supplies outgoing evidence.
A directed transition therefore compares the source’s outgoing key with the destination’s incoming key. Reversing the tracks asks a different question and can produce a different result.
Whole-track matching recombines both halves by analyzed duration and classifies one key. It is useful when one stable summary is preferable, while start/end matching retains more information about how a track may enter and leave.
7.3. Directed Harmonic Relationships
A relation rule accepts a directed pair of modal states. It may preserve a root or mode, move a root by an interval or circle-of-fifths step, move between specific modes, or combine several alternatives.
The General Purpose profile covers four useful corners: same or +5-semitone root movement crossed with same or next-mode movement. The two Brightening experiments move through Phrygian → Aeolian → Dorian → Mixolydian → Ionian → Lydian without wrapping.
These names describe harmonic policy, not an automatic emotional arc. Library coverage, track arrangement, and the available graph determine what a complete Mix actually becomes.
7.4. Contours and Confidence
The key contour changes how frequency evidence contributes to detection and harmonic-detail ranking. None is calibrated-flat, ECMA-418 is the release default, and the two ISO 226 profiles vary with reference SPL.
The selected profile can change a derived key without rescanning because Harmonic DJ retains the underlying calibrated harmonic evidence. Gain analysis is separate and remains fixed so changing the key contour cannot move previously copied gain recommendations.
Key confidence is an uncalibrated separation heuristic: it describes how strongly the selected category separated from nearby alternatives inside the current model. It is useful context, not a promise of musical certainty and not a rejection threshold.
7.5. BPM, Pitch, and Gain
BPM is a Mix constraint rather than a reward. A track either satisfies the selected BPM policy or it does not. This prevents a harmonically strong but tempo-incompatible edge from slipping into a route through a weighted average.
Pitch-shifted playback changes speed and pitch together. Harmonic DJ transposes the track’s effective keys and harmonic evidence by the same integer-semitone step used to reach the Mix BPM.
Gain guidance is also independent from route selection. Per-track ECMA-relative gain helps neighboring tracks meet at a stable subjective level, while the common pre-limiter gain places the complete adjusted Mix near its integrated-LUFS target.
8. Sharing, Files, and Privacy
Harmonic DJ separates local user state from portable metadata. Audio stays local unless you independently move or publish it through some other service.
8.1. Shared Collections
Export Collection creates a versioned .hdjcollection file from the complete local Library, Ungrouped, or the currently selected local group. Name the collection before choosing its destination.
The file contains stable collection and track identifiers, sender-defined groups, structured identity, BPM and confidence, key evidence and derived profiles, and loudness analysis. It excludes local paths, audio, personal ratings, Gems, Mix documents, and private Library state.
Import Shared Collection adds that path-free snapshot as a named remote collection. Reimporting a newer export with the same collection and track identifiers updates the existing records instead of creating duplicates. Sender groups remain scoped beneath their collection.
Manage Shared Collections removes imported metadata without changing local tracks. Imported collections cannot currently be re-exported as if they were your own local collection.
8.2. Library Metadata
Export Library Metadata writes a path-based JSON snapshot intended for your own backup or transfer between compatible file layouts. Unlike a shared collection, it includes local file paths, personal ratings, and other private Library state.
Import Library Metadata validates those paths and restores compatible records into the local database. It does not contain the audio itself, so the referenced files still need to exist at the stored locations.
Use .hdjcollection for friend-to-friend sharing. Use the Library metadata JSON when preserving your own local analysis and paths is the purpose.
8.3. Mix and Preset Files
A .hdjmix file contains the current Mix document: its track references, order, roles, locks, exclusions, target values, key profile, transition-profile snapshot, rules, authored incoming-transition explanations and context, sharing details, and other planning state. It does not contain audio, private undo history, or the live association with a published Mix page. Importing the file creates a new local Mix identity, so it cannot update or advertise the source Mix’s published page. Duplicate Mix follows the same rule.
Exported transition presets contain a reusable transition profile. Applying one copies that profile into the active Mix; the Mix does not depend on the preset file remaining available later.
Mix import and export, along with transition-preset management, are available in Community. Imported Mixes remain readable and auditionable there; Pro is required to edit them as durable Mix documents. Imported Mixes and presets are validated before replacing local state. Keep exports alongside normal project backups when a tracklist or custom relationship is important.
8.4. Publishing a Mix
Community can copy or publish its temporary Tracklist Preview. Pro can share complete saved Mixes. Open Share to review the exact title, optional DJ / creator byline, and track display names that will be public. Corrections made here belong to this Mix only. Copy Tracklist works without publishing and uses the Harmonic DJ product link until the current snapshot has its own page.
Choose Publish Mix to create that page. The first time this installation publishes, enter an email address. Harmonic DJ sends a review link; opening it shows the pending tracklist, and Publish and view Mix performs the actual publication. Merely opening the email does not publish anything. If the Share page remains open, it notices the confirmation automatically; View Mix and Unpublish then appear as outlined secondary buttons beside the publication status.
Successful confirmation also establishes a publishing credential on this computer. Later Mixes normally publish immediately without another email. If the credential is missing or rejected, Harmonic DJ asks for email verification again.
Editing a Mix never changes its public page by itself. After the first publication, the primary action becomes Update Mix; choosing it replaces the snapshot at the same canonical URL. Harmonic DJ stores the publication association with that saved Mix, so switching Mixes or restarting the application retains its published state. If email verification is required again, the existing version stays public until the reviewed update is confirmed. The page remains public until explicitly unpublished, and the linked copy-ready tracklist contains its permanent URL. Unpublishing permanently retires that URL; publishing the same local Mix again is allowed and creates a new URL.
Published pages contain visible tracklist and strategy details only. They never contain audio, local file paths, private Mix history, Library groups, locks, exclusions, or raw analysis evidence. Anyone with a published URL can view it, and the page may be indexed like an ordinary public web page.
8.5. Remote Tracks and Find Online
A shared track may participate in planning even when its audio is unavailable locally. Harmonic DJ keeps that state explicit instead of showing it as a missing file or silently removing it from the candidate pool.
Find Online uses available identity metadata to open a MusicBrainz recording or search, a descriptive Beatport search, or a SoundCloud search. This is a lookup convenience rather than a purchasing, downloading, or matching service.
When you legally obtain the audio, add it through the ordinary Library workflow. The local track becomes the canonical playable record; there is no separate manual-link path that bypasses normal analysis.
8.6. Privacy
Commercial audio is not embedded in Library metadata, shared collections, Mix documents, transition presets, or published Mix pages. Harmonic DJ does not upload audio for license checks or proxy it between users.
Local Library paths remain local unless you deliberately use the path-based Library Metadata export. Shared collections are the path-free format intended for another person.
Share Mix corrections are stored with that Mix and do not rewrite source tags. Copying a tracklist places only the visible text on the clipboard. Publishing sends only the reviewed public snapshot. The email address is used to deliver verification and is not added to a newsletter or embedded in the page.
9. Community and Pro
Community and Pro use the same detector, key profiles, default ranking, and audio Library. Pro adds larger saved Mixes, Gem Finder, and reusable Gems.
9.1. Community
Community is free forever and does not require an account. It includes unlimited local analysis, Library search and management, personal track ratings, audition, key-profile selection, groups, local metadata, portable collection exchange, and the complete Settings surface.
Its Mix workspace is a temporary, editable Tracklist Preview of up to five tracks. You can seed it from Library, generate, lock positions, replace alternatives, remove tracks, apply exclusions, and regenerate.
Community can import and export Mix files, manage transition presets, copy or publish its Tracklist Preview, and drag playable local tracks from Mixes and Gems into other applications. It can also open and audition existing Pro Mixes and Gems. Creating or editing saved Mixes beyond the five-track Community limit remains a Pro feature.
9.2. Pro
Pro unlocks creating and editing named, auto-saved Mix documents, exact target counts above five, arbitrary track placement, persistent undo and redo, Gem Finder, and saving, rating, and reusing directed Gems.
Visit the APU Harmonic DJ product page to see current Pro pricing or purchase Pro.
9.3. Trial and License Changes
Open About to start the standard APU Pro trial or activate a license. The trial unlocks the same local features as paid Pro and does not require a payment card.
If Pro becomes active while a non-empty Community Tracklist Preview is open or finishing, Harmonic DJ saves that preview as its own named Mix and leaves the previously open saved Mix intact.
When a trial expires or a license becomes inactive, Harmonic DJ returns to Community. The Library, Gems, shared collections, transition presets, and Mix documents remain stored. Existing Pro work stays readable and auditionable while Pro-only creation and editing actions are unavailable.
If Pro access changes during a long generation, Harmonic DJ leaves the existing saved Mix unchanged rather than committing a partial result.
10. Troubleshooting and Reference
Start with the status line at the top of Harmonic DJ. Long operations report their current phase, and most rejected actions explain the specific requirement that was not met.
10.1. Track States
Ready to mix means the local track has the analysis required for planning. Needs attention collects incomplete or failed local analysis. Select the track to inspect its status, then use Rescan after correcting the underlying file or decoder problem.
Missing files are local records whose stored path no longer exists. If a file moved, add it from the new location before cleanup; one byte-identical, unambiguous content match updates the Library and saved Mix paths automatically. Show in Folder opens the last known parent when possible, and Remove Missing Files permanently cleans up the remaining records after confirmation.
A shared track is intentionally metadata-only. It can support planning and online lookup but cannot be auditioned or dragged as a local audio file.
10.2. Generation and Candidate Problems
Mix generation must fill the exact requested track count. If it cannot, the current tracklist is left unchanged. Common causes include:
- Too few ready and unique tracks in the selected groups
- A focused transition profile with too few compatible edges
- A strict BPM rule or narrow pitch-shift range
- Allowed roots or modes that exclude most of the Library
- Required stable or changing start/end keys
- Locked positions that cannot be connected
- Position, segment, or whole-Mix exclusions
Gem Finder intentionally ignores Mix groups and exclusions, but it still requires an unused track that passes BPM, Allowed Keys, key matching, and any start/end relationship requirement. A shared candidate can be planned but not auditioned until local audio is added normally.
10.3. Audio and M4A Playback
If a local track will not analyze or play, confirm that the file still exists and appears in the Add Files chooser for the current platform. Then rescan the track and read the status message.
On Windows, AAC and ALAC M4A decoding depends on Microsoft Media Foundation. Windows N and KN editions normally require the Media Feature Pack from Settings → Apps → Optional Features followed by a restart. The Harmonic DJ installer checks for the required components and offers to open that settings page.
On macOS, M4A uses Core Audio. Linux builds advertise only the formats available through their registered readers.
10.4. Cancellation and Recovery
Canceling discovery, analysis, metadata transfer, or generation is cooperative. The current unit of work may take a moment to stop cleanly.
Completed Library analysis is retained. An interrupted current track returns to the durable queue. Canceling Mix generation leaves the previous tracklist in place.
Mix documents are auto-saved and keep bounded revision history. If the current projection needs repair after an interrupted write, Harmonic DJ can recover it from the saved history manifest without placing that private history inside an exported .hdjmix file.
10.5. Glossary
Allowed Keys: Independent root and mode filters applied to both boundaries of every eligible Mix track.
Gem: A saved, directed source-to-destination transition approved by the listener.
Harmonic detail: Soft reranking evidence derived from fuller harmonic distributions after a transition is already accepted.
Incoming / outgoing key: The detected key used where a track enters or leaves under start/end matching.
Mix: A tracklist plus the complete planning and sharing state used to create and refine it.
Parent key: The Ionian pitch collection associated with a modal key.
Pre-limiter gain: One common gain recommendation that places the gain-adjusted Mix near its integrated-loudness target before final limiting.
Relation rule: One named directed harmonic predicate inside a transition profile.
Shared collection: A path-free, audio-free snapshot of track identity and analysis metadata.
Transition profile: The ordered collection of enabled relation rules owned by a Mix.
11. Credits
This software was developed by APU Software, LLC and is available as a standalone application for Windows (x64 and x86), macOS (universal), and Linux (x64). The software libraries below are utilized for portions of the software:
- JUCE (cross-platform audio and user interface framework)
- Boost (header-only algorithms)
- r8brain (sample rate conversion)
- PFFFT (FFT library)
- TagLib (audio metadata)
- utf8cpp (Unicode support used by TagLib)
TagLib’s corresponding source is available in the APUSoftware/taglib repository.
11.1. MIT License (r8brain)
Copyright (c) 2013-2023 Aleksey Vaneev
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
11.2. FFTPACK License (pffft)
Copyright (c) 2013 Julien Pommier ( pommier@modartt.com )
Based on original fortran 77 code from FFTPACKv4 from NETLIB,
authored by Dr Paul Swarztrauber of NCAR, in 1985.
As confirmed by the NCAR fftpack software curators, the following
FFTPACKv5 license applies to FFTPACKv4 sources. My changes are
released under the same terms.
FFTPACK license:
http://www.cisl.ucar.edu/css/software/fftpack5/ftpk.html
Copyright (c) 2004 the University Corporation for Atmospheric
Research ("UCAR"). All rights reserved. Developed by NCAR's
Computational and Information Systems Laboratory, UCAR,
www.cisl.ucar.edu.
Redistribution and use of the Software in source and binary forms,
with or without modification, is permitted provided that the
following conditions are met:
- Neither the names of NCAR's Computational and Information Systems
Laboratory, the University Corporation for Atmospheric Research,
nor the names of its sponsors or contributors may be used to
endorse or promote products derived from this Software without
specific prior written permission.
- Redistributions of source code must retain the above copyright
notices, this list of conditions, and the disclaimer below.
- Redistributions in binary form must reproduce the above copyright
notice, this list of conditions, and the disclaimer below in the
documentation and/or other materials provided with the
distribution.
THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE CONTRIBUTORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE
SOFTWARE.
11.3. Mozilla Public License 1.1 (TagLib)
MOZILLA PUBLIC LICENSE
Version 1.1
---------------
1. Definitions.
1.0.1. "Commercial Use" means distribution or otherwise making the
Covered Code available to a third party.
1.1. "Contributor" means each entity that creates or contributes to
the creation of Modifications.
1.2. "Contributor Version" means the combination of the Original
Code, prior Modifications used by a Contributor, and the Modifications
made by that particular Contributor.
1.3. "Covered Code" means the Original Code or Modifications or the
combination of the Original Code and Modifications, in each case
including portions thereof.
1.4. "Electronic Distribution Mechanism" means a mechanism generally
accepted in the software development community for the electronic
transfer of data.
1.5. "Executable" means Covered Code in any form other than Source
Code.
1.6. "Initial Developer" means the individual or entity identified
as the Initial Developer in the Source Code notice required by Exhibit
A.
1.7. "Larger Work" means a work which combines Covered Code or
portions thereof with code not governed by the terms of this License.
1.8. "License" means this document.
1.8.1. "Licensable" means having the right to grant, to the maximum
extent possible, whether at the time of the initial grant or
subsequently acquired, any and all of the rights conveyed herein.
1.9. "Modifications" means any addition to or deletion from the
substance or structure of either the Original Code or any previous
Modifications. When Covered Code is released as a series of files, a
Modification is:
A. Any addition to or deletion from the contents of a file
containing Original Code or previous Modifications.
B. Any new file that contains any part of the Original Code or
previous Modifications.
1.10. "Original Code" means Source Code of computer software code
which is described in the Source Code notice required by Exhibit A as
Original Code, and which, at the time of its release under this
License is not already Covered Code governed by this License.
1.10.1. "Patent Claims" means any patent claim(s), now owned or
hereafter acquired, including without limitation, method, process,
and apparatus claims, in any patent Licensable by grantor.
1.11. "Source Code" means the preferred form of the Covered Code for
making modifications to it, including all modules it contains, plus
any associated interface definition files, scripts used to control
compilation and installation of an Executable, or source code
differential comparisons against either the Original Code or another
well known, available Covered Code of the Contributor's choice. The
Source Code can be in a compressed or archival form, provided the
appropriate decompression or de-archiving software is widely available
for no charge.
1.12. "You" (or "Your") means an individual or a legal entity
exercising rights under, and complying with all of the terms of, this
License or a future version of this License issued under Section 6.1.
For legal entities, "You" includes any entity which controls, is
controlled by, or is under common control with You. For purposes of
this definition, "control" means (a) the power, direct or indirect,
to cause the direction or management of such entity, whether by
contract or otherwise, or (b) ownership of more than fifty percent
(50%) of the outstanding shares or beneficial ownership of such
entity.
2. Source Code License.
2.1. The Initial Developer Grant.
The Initial Developer hereby grants You a world-wide, royalty-free,
non-exclusive license, subject to third party intellectual property
claims:
(a) under intellectual property rights (other than patent or
trademark) Licensable by Initial Developer to use, reproduce,
modify, display, perform, sublicense and distribute the Original
Code (or portions thereof) with or without Modifications, and/or
as part of a Larger Work; and
(b) under Patents Claims infringed by the making, using or
selling of Original Code, to make, have made, use, practice,
sell, and offer for sale, and/or otherwise dispose of the
Original Code (or portions thereof).
(c) the licenses granted in this Section 2.1(a) and (b) are
effective on the date Initial Developer first distributes
Original Code under the terms of this License.
(d) Notwithstanding Section 2.1(b) above, no patent license is
granted: 1) for code that You delete from the Original Code; 2)
separate from the Original Code; or 3) for infringements caused
by: i) the modification of the Original Code or ii) the
combination of the Original Code with other software or devices.
2.2. Contributor Grant.
Subject to third party intellectual property claims, each Contributor
hereby grants You a world-wide, royalty-free, non-exclusive license
(a) under intellectual property rights (other than patent or
trademark) Licensable by Contributor, to use, reproduce, modify,
display, perform, sublicense and distribute the Modifications
created by such Contributor (or portions thereof) either on an
unmodified basis, with other Modifications, as Covered Code
and/or as part of a Larger Work; and
(b) under Patent Claims infringed by the making, using, or
selling of Modifications made by that Contributor either alone
and/or in combination with its Contributor Version (or portions
of such combination), to make, use, sell, offer for sale, have
made, and/or otherwise dispose of: 1) Modifications made by that
Contributor (or portions thereof); and 2) the combination of
Modifications made by that Contributor with its Contributor
Version (or portions of such combination).
(c) the licenses granted in Sections 2.2(a) and 2.2(b) are
effective on the date Contributor first makes Commercial Use of
the Covered Code.
(d) Notwithstanding Section 2.2(b) above, no patent license is
granted: 1) for any code that Contributor has deleted from the
Contributor Version; 2) separate from the Contributor Version;
3) for infringements caused by: i) third party modifications of
Contributor Version or ii) the combination of Modifications made
by that Contributor with other software (except as part of the
Contributor Version) or other devices; or 4) under Patent Claims
infringed by Covered Code in the absence of Modifications made by
that Contributor.
3. Distribution Obligations.
3.1. Application of License.
The Modifications which You create or to which You contribute are
governed by the terms of this License, including without limitation
Section 2.2. The Source Code version of Covered Code may be
distributed only under the terms of this License or a future version
of this License released under Section 6.1, and You must include a
copy of this License with every copy of the Source Code You
distribute. You may not offer or impose any terms on any Source Code
version that alters or restricts the applicable version of this
License or the recipients' rights hereunder. However, You may include
an additional document offering the additional rights described in
Section 3.5.
3.2. Availability of Source Code.
Any Modification which You create or to which You contribute must be
made available in Source Code form under the terms of this License
either on the same media as an Executable version or via an accepted
Electronic Distribution Mechanism to anyone to whom you made an
Executable version available; and if made available via Electronic
Distribution Mechanism, must remain available for at least twelve (12)
months after the date it initially became available, or at least six
(6) months after a subsequent version of that particular Modification
has been made available to such recipients. You are responsible for
ensuring that the Source Code version remains available even if the
Electronic Distribution Mechanism is maintained by a third party.
3.3. Description of Modifications.
You must cause all Covered Code to which You contribute to contain a
file documenting the changes You made to create that Covered Code and
the date of any change. You must include a prominent statement that
the Modification is derived, directly or indirectly, from Original
Code provided by the Initial Developer and including the name of the
Initial Developer in (a) the Source Code, and (b) in any notice in an
Executable version or related documentation in which You describe the
origin or ownership of the Covered Code.
3.4. Intellectual Property Matters
(a) Third Party Claims.
If Contributor has knowledge that a license under a third party's
intellectual property rights is required to exercise the rights
granted by such Contributor under Sections 2.1 or 2.2,
Contributor must include a text file with the Source Code
distribution titled "LEGAL" which describes the claim and the
party making the claim in sufficient detail that a recipient will
know whom to contact. If Contributor obtains such knowledge after
the Modification is made available as described in Section 3.2,
Contributor shall promptly modify the LEGAL file in all copies
Contributor makes available thereafter and shall take other steps
(such as notifying appropriate mailing lists or newsgroups)
reasonably calculated to inform those who received the Covered
Code that new knowledge has been obtained.
(b) Contributor APIs.
If Contributor's Modifications include an application programming
interface and Contributor has knowledge of patent licenses which
are reasonably necessary to implement that API, Contributor must
also include this information in the LEGAL file.
(c) Representations.
Contributor represents that, except as disclosed pursuant to
Section 3.4(a) above, Contributor believes that Contributor's
Modifications are Contributor's original creation(s) and/or
Contributor has sufficient rights to grant the rights conveyed by
this License.
3.5. Required Notices.
You must duplicate the notice in Exhibit A in each file of the Source
Code. If it is not possible to put such notice in a particular Source
Code file due to its structure, then You must include such notice in a
location (such as a relevant directory) where a user would be likely
to look for such a notice. If You created one or more Modification(s)
You may add your name as a Contributor to the notice described in
Exhibit A. You must also duplicate this License in any documentation
for the Source Code where You describe recipients' rights or ownership
rights relating to Covered Code. You may choose to offer, and to
charge a fee for, warranty, support, indemnity or liability
obligations to one or more recipients of Covered Code. However, You
may do so only on Your own behalf, and not on behalf of the Initial
Developer or any Contributor. You must make it absolutely clear than
any such warranty, support, indemnity or liability obligation is
offered by You alone, and You hereby agree to indemnify the Initial
Developer and every Contributor for any liability incurred by the
Initial Developer or such Contributor as a result of warranty,
support, indemnity or liability terms You offer.
3.6. Distribution of Executable Versions.
You may distribute Covered Code in Executable form only if the
requirements of Section 3.1-3.5 have been met for that Covered Code,
and if You include a notice stating that the Source Code version of
the Covered Code is available under the terms of this License,
including a description of how and where You have fulfilled the
obligations of Section 3.2. The notice must be conspicuously included
in any notice in an Executable version, related documentation or
collateral in which You describe recipients' rights relating to the
Covered Code. You may distribute the Executable version of Covered
Code or ownership rights under a license of Your choice, which may
contain terms different from this License, provided that You are in
compliance with the terms of this License and that the license for the
Executable version does not attempt to limit or alter the recipient's
rights in the Source Code version from the rights set forth in this
License. If You distribute the Executable version under a different
license You must make it absolutely clear that any terms which differ
from this License are offered by You alone, not by the Initial
Developer or any Contributor. You hereby agree to indemnify the
Initial Developer and every Contributor for any liability incurred by
the Initial Developer or such Contributor as a result of any such
terms You offer.
3.7. Larger Works.
You may create a Larger Work by combining Covered Code with other code
not governed by the terms of this License and distribute the Larger
Work as a single product. In such a case, You must make sure the
requirements of this License are fulfilled for the Covered Code.
4. Inability to Comply Due to Statute or Regulation.
If it is impossible for You to comply with any of the terms of this
License with respect to some or all of the Covered Code due to
statute, judicial order, or regulation then You must: (a) comply with
the terms of this License to the maximum extent possible; and (b)
describe the limitations and the code they affect. Such description
must be included in the LEGAL file described in Section 3.4 and must
be included with all distributions of the Source Code. Except to the
extent prohibited by statute or regulation, such description must be
sufficiently detailed for a recipient of ordinary skill to be able to
understand it.
5. Application of this License.
This License applies to code to which the Initial Developer has
attached the notice in Exhibit A and to related Covered Code.
6. Versions of the License.
6.1. New Versions.
Netscape Communications Corporation ("Netscape") may publish revised
and/or new versions of the License from time to time. Each version
will be given a distinguishing version number.
6.2. Effect of New Versions.
Once Covered Code has been published under a particular version of the
License, You may always continue to use it under the terms of that
version. You may also choose to use such Covered Code under the terms
of any subsequent version of the License published by Netscape. No one
other than Netscape has the right to modify the terms applicable to
Covered Code created under this License.
6.3. Derivative Works.
If You create or use a modified version of this License (which you may
only do in order to apply it to code which is not already Covered Code
governed by this License), You must (a) rename Your license so that
the phrases "Mozilla", "MOZILLAPL", "MOZPL", "Netscape",
"MPL", "NPL" or any confusingly similar phrase do not appear in your
license (except to note that your license differs from this License)
and (b) otherwise make it clear that Your version of the license
contains terms which differ from the Mozilla Public License and
Netscape Public License. (Filling in the name of the Initial
Developer, Original Code or Contributor in the notice described in
Exhibit A shall not of themselves be deemed to be modifications of
this License.)
7. DISCLAIMER OF WARRANTY.
COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
WITHOUT LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF
DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING.
THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED CODE
IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT,
YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE
COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF
ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.
8. TERMINATION.
8.1. This License and the rights granted hereunder will terminate
automatically if You fail to comply with terms herein and fail to cure
such breach within 30 days of becoming aware of the breach. All
sublicenses to the Covered Code which are properly granted shall
survive any termination of this License. Provisions which, by their
nature, must remain in effect beyond the termination of this License
shall survive.
8.2. If You initiate litigation by asserting a patent infringement
claim (excluding declatory judgment actions) against Initial Developer
or a Contributor (the Initial Developer or Contributor against whom
You file such action is referred to as "Participant") alleging that:
(a) such Participant's Contributor Version directly or indirectly
infringes any patent, then any and all rights granted by such
Participant to You under Sections 2.1 and/or 2.2 of this License
shall, upon 60 days notice from Participant terminate prospectively,
unless if within 60 days after receipt of notice You either: (i)
agree in writing to pay Participant a mutually agreeable reasonable
royalty for Your past and future use of Modifications made by such
Participant, or (ii) withdraw Your litigation claim with respect to
the Contributor Version against such Participant. If within 60 days
of notice, a reasonable royalty and payment arrangement are not
mutually agreed upon in writing by the parties or the litigation claim
is not withdrawn, the rights granted by Participant to You under
Sections 2.1 and/or 2.2 automatically terminate at the expiration of
the 60 day notice period specified above.
(b) any software, hardware, or device, other than such Participant's
Contributor Version, directly or indirectly infringes any patent, then
any rights granted to You by such Participant under Sections 2.1(b)
and 2.2(b) are revoked effective as of the date You first made, used,
sold, distributed, or had made, Modifications made by that
Participant.
8.3. If You assert a patent infringement claim against Participant
alleging that such Participant's Contributor Version directly or
indirectly infringes any patent where such claim is resolved (such as
by license or settlement) prior to the initiation of patent
infringement litigation, then the reasonable value of the licenses
granted by such Participant under Sections 2.1 or 2.2 shall be taken
into account in determining the amount or value of any payment or
license.
8.4. In the event of termination under Sections 8.1 or 8.2 above,
all end user license agreements (excluding distributors and resellers)
which have been validly granted by You or any distributor hereunder
prior to termination shall survive termination.
9. LIMITATION OF LIABILITY.
UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT
(INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL
DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED CODE,
OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR
ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY
CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL,
WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER
COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN
INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF
LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY
RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW
PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE
EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO
THIS EXCLUSION AND LIMITATION MAY NOT APPLY TO YOU.
10. U.S. GOVERNMENT END USERS.
The Covered Code is a "commercial item," as that term is defined in
48 C.F.R. 2.101 (Oct. 1995), consisting of "commercial computer
software" and "commercial computer software documentation," as such
terms are used in 48 C.F.R. 12.212 (Sept. 1995). Consistent with 48
C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995),
all U.S. Government End Users acquire Covered Code with only those
rights set forth herein.
11. MISCELLANEOUS.
This License represents the complete agreement concerning subject
matter hereof. If any provision of this License is held to be
unenforceable, such provision shall be reformed only to the extent
necessary to make it enforceable. This License shall be governed by
California law provisions (except to the extent applicable law, if
any, provides otherwise), excluding its conflict-of-law provisions.
With respect to disputes in which at least one party is a citizen of,
or an entity chartered or registered to do business in the United
States of America, any litigation relating to this License shall be
subject to the jurisdiction of the Federal Courts of the Northern
District of California, with venue lying in Santa Clara County,
California, with the losing party responsible for costs, including
without limitation, court costs and reasonable attorneys' fees and
expenses. The application of the United Nations Convention on
Contracts for the International Sale of Goods is expressly excluded.
Any law or regulation which provides that the language of a contract
shall be construed against the drafter shall not apply to this
License.
12. RESPONSIBILITY FOR CLAIMS.
As between Initial Developer and the Contributors, each party is
responsible for claims and damages arising, directly or indirectly,
out of its utilization of rights under this License and You agree to
work with Initial Developer and Contributors to distribute such
responsibility on an equitable basis. Nothing herein is intended or
shall be deemed to constitute any admission of liability.
13. MULTIPLE-LICENSED CODE.
Initial Developer may designate portions of the Covered Code as
"Multiple-Licensed". "Multiple-Licensed" means that the Initial
Developer permits you to utilize portions of the Covered Code under
Your choice of the NPL or the alternative licenses, if any, specified
by the Initial Developer in the file described in Exhibit A.
EXHIBIT A -Mozilla Public License.
``The contents of this file are subject to the Mozilla Public License
Version 1.1 (the "License"); you may not use this file except in
compliance with the License. You may obtain a copy of the License at
http://www.mozilla.org/MPL/
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations
under the License.
The Original Code is ______________________________________.
The Initial Developer of the Original Code is ________________________.
Portions created by ______________________ are Copyright (C) ______
_______________________. All Rights Reserved.
Contributor(s): ______________________________________.
Alternatively, the contents of this file may be used under the terms
of the _____ license (the "[___] License"), in which case the
provisions of [______] License are applicable instead of those
above. If you wish to allow use of your version of this file only
under the terms of the [____] License and not to allow others to use
your version of this file under the MPL, indicate your decision by
deleting the provisions above and replace them with the notice and
other provisions required by the [___] License. If you do not delete
the provisions above, a recipient may use your version of this file
under either the MPL or the [___] License."
[NOTE: The text of this Exhibit A may differ slightly from the text of
the notices in the Source Code files of the Original Code. You should
use the text of this Exhibit A rather than the text found in the
Original Code Source Code for Your Modifications.]
11.4. Boost Software License 1.0 (utf8cpp)
Copyright 2006-2022 Nemanja Trifunovic
Boost Software License - Version 1.0 - August 17th, 2003
Permission is hereby granted, free of charge, to any person or organization
obtaining a copy of the software and accompanying documentation covered by
this license (the "Software") to use, reproduce, display, distribute,
execute, and transmit the Software, and to prepare derivative works of the
Software, and to permit third-parties to whom the Software is furnished to
do so, all subject to the following:
The copyright notices in the Software and this entire statement, including
the above license grant, this restriction and the following disclaimer,
must be included in all copies of the Software, in whole or in part, and
all derivative works of the Software, unless such copies or derivative
works are solely in the form of machine-executable object code generated by
a source language processor.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.