Knowthelist is a feature-packed, cross-platform DJ mixer and music player built for DJs and party hosts who need to react instantly while mixing. Queue up your crowd's requests in real-time, beat-sync two decks, set auto-DJ filters, and deliver flawless transitions — all with a beautiful, responsive interface.

The Auto DJ does more than apply one fixed crossfade. Its transition planner reevaluates the upcoming pair whenever the current or waiting track changes, then selects an explainable transition profile based on BPM and musical style hints. Matching BPMs prioritize beat and phrase alignment by default, even when genre metadata is missing or inconsistent. All transition modes are enabled by default and can be adjusted under Settings → Transitions:

• Beat / phrase blend for compatible dance tracks
• Bass swap to prevent kick and bass masking
• Vocal / mid handoff so the incoming lead remains dominant
• Equal-power blend as the neutral, perceptually smooth fallback
• Hard cut for large tempo or style changes

The planner also respects duration limits, maximum tempo correction, and the selected style bias. Beat matching remains an automatic capability rather than a separate manual mixer toggle.

Runs natively on Linux, macOS and Windows.

# 1. Install system dependencies
sudo apt install build-essential cmake qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-l10n-tools \
    libtag1-dev libasound2-dev libsoundtouch-dev \
    libfreetype6-dev libfontconfig1-dev libegl1-mesa-dev libxkbcommon-dev \
    libgl1-mesa-dev libx11-dev libxext-dev libxrandr-dev libxinerama-dev \
    libxcursor-dev libxi-dev libxcomposite-dev libx11-xcb-dev \
    libcurl4-openssl-dev

# 2. Get the source
git clone https://github.com/knowthelist/knowthelist.git
cd knowthelist

# 3. Build with CMake (recommended)
cmake -S . -B build
cmake --build build -j$(nproc)

# 4. Run
./build/knowthelist

qt6-tools-dev provides the Qt6LinguistTools CMake component required by the project. If CMake reports that Qt6LinguistToolsConfig.cmake is missing, install this package and rerun the configure command.

JUCE cache: JUCE is cached outside build/ (default: ~/.cache/knowthelist/fetchcontent on Linux/macOS). Running rm -rf build won't re-download it. Override with -DKNOWTHELIST_FETCHCONTENT_DIR=/path/to/cache.

# 1. Install dependencies via Homebrew
brew install qt taglib soundtouch

# 2. Get the source
git clone https://github.com/knowthelist/knowthelist.git
cd knowthelist

# 3a. qmake build
qmake6 && make -j$(sysctl -n hw.ncpu)

# 3b. Or CMake (recommended)
cmake -S . -B build && cmake --build build -j$(sysctl -n hw.ncpu)

# 4. Run
./build/knowthelist

The app compiles to a .app bundle — drop it into /Applications. An icon will appear in Spotlight.

1. Install Qt 6+ (incl. Qt Creator) and CMake.
2. Build taglib with CMake, then add its bin path to your Qt Creator build environment.
3. Open the project in Qt Creator → Build & Run (Ctrl+R).

A prebuilt Windows package is also available on the Releases page.

sudo apt install knowthelist

Pre-built Linux packages are also available on the Releases page.

Download the latest installer from the Releases page.

Pushing a version tag such as v2.4.0 starts the GitHub Actions release workflow. It builds the macOS and Windows application bundles, Linux .deb/.rpm packages, and source .zip and .tar.gz archives on clean runners. Release artifacts are currently unsigned; macOS may require allowing the downloaded app in System Settings > Privacy & Security.

UI headers are generated by Qt Designer — do not edit them manually.

# CMake (recommended):
cmake -S . -B build && cmake --build build --target knowthelist_autogen

# Force full regenerate:
rm -rf build && cmake -S . -B build && cmake --build build -j$(nproc)

# qmake:
qmake6 knowthelist.pro && make clean && make -j$(nproc)