rrrapha / mixxx

Mixxx is Free DJ software that gives you everything you need to perform live mixes.

Mixxx

Mixxx is Free DJ software that gives you everything you need to perform live DJ mixes. Mixxx works on GNU/Linux, Windows, and macOS.

Quick Start

To get started with Mixxx:

1. For live use, download the latest stable version.
2. For experimentation and testing, download a development release.
3. To live on the bleeding edge, clone the repo: git clone https://github.com/mixxxdj/mixxx.git

Roadmap

The Mixxx team is hard at work on Mixxx 2.3. The best place to keep track of 2.3 development is the 2.3.0 milestone page on Launchpad.

A more general roadmap can be found on the wiki.

Bug tracker

The Mixxx team uses Launchpad to manage Mixxx development.

Have a bug or feature request? File a bug on Launchpad.

Want to get involved in Mixxx development? Assign yourself a bug from the easy bug list and get started!

Compiling on Linux

$ mkdir build
$ cd build
$ cmake ..
$ cmake --build .

Please see our helpful guide on the wiki for more information: Compiling on Linux

Compiling on MacOS

$ mkdir build
$ cd build
$ cmake ..
$ cmake --build .

Please see our helpful guide on the wiki for more information: Compiling on MacOS

Compiling on Windows

Build Requirements

• Windows 7 or later
• MS Visual Studio 2019 (Community Edition is free of charge)
• At least 10G free diskspace
• To create an .msi installer, you need to install the WiX toolkit from https://wixtoolset.org/releases/

Setup your build environment

1. Download these sources (using git checkout as described in Using Git)
2. Run the batch file tools\windows_buildenv.bat
   • This file downloads the prebuild Mixxx environment, defined in cmake\windows_build_environment_name from https://downloads.mixxx.org/builds/buildserver/2.3.x-windows/
   • Generates the CMakeSettings.json with the matching build configurations for Visual Studio
3. Start Visual Studio, choose "Open a local folder" select the mixxx directory containing CMakeSettings.json
4. Menu "Project" -> "Generate Cache for mixxx"
5. Select the build configuration in the toolbar (x64__portable is recommended)
6. Menu "Build" -> "Build All"

Creating an .msi installer (optional)

7. Than open the Visual Studio 'Developer Command Prompt' by Menu -> "Tools" -> "Command line" -> "Developer Command Prompt"
8. Go to your build directory, e.g. by "cd .\build\x64-portable"
9. Run "cpack -G WIX"

Please see also our helpful guide on the wiki for more information: Compiling on Windows

Documentation

For help using Mixxx, there are a variety of options:

• Mixxx manual
• Mixxx wiki
• Frequently Asked Questions
• Hardware Compatibility
• Creating Skins

Translation

Help to spread Mixxx with translations into more languages, as well as to update and ensure the accuracy of existing translations.

• Help translate content
• Mixxx i18n wiki
• Mixxx localization forum
• Mixxx glossary

Community

Mixxx is a vibrant community of hackers, DJs and artists. To keep track of development and community news:

• Chat with us on Zulip.
• Follow us on Twitter and Facebook.
• Subscribe to the Mixxx Development Blog.
• Join the developer mailing list.
• Post on the Mixxx forums.

License

Mixxx is released under the GPLv2. See the LICENSE file for a full copy of the license.