README.md

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__fastbuild 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-fastbuild"
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.