Home

Mixxx

Mixxx is open-source software with a broad community encompassing performing musicians, amateur DJs, internet radio broadcasters and casual users. The Mixxx Wiki contains useful information for users, developers and artists. It covers first steps if you are new to DJing, has a hardware guide to learn about supported controllers, provides help so you don't get stuck when running into trouble and is a great resource for developers.

Due to spam attacks, wiki editing has been restricted. However you are welcome to add information or change existing documentation. To do so, please send your suggestions by creating a new topic in the Documentation Stream on Zulip. If you find outdated, incorrect or incomplete information on the wiki, sending corrections would be very much appreciated.

User Documentation

Getting Started

Troubleshooting

Troubleshooting
Finding the Mixxx.log file can be helpful when Mixxx isn't working right. Please attach this file to bug reports and forum posts when asking for help.
Adjusting Audio Latency

Getting Involved

Reporting bugs is a great way to contribute to Mixxx, especially if you don't have programming skills
Testing the latest features helps speed up development
Getting Involved in Mixxx: Want Mixxx to be even more awesome? You don't need to be a programmer to help us.
Google Summer of Code

Extras

Live GNU/Linux distributions featuring Mixxx: Run Mixxx from a USB drive or DVD without having to install anything on the computer
Live Calls with Skype and Mixxx
MIDI clock output

Community Resources

Mixxx website
Development builds: Please help us test the latest code and report bugs. We try to make sure code is reasonably stable before including it in these, but only use development builds if you are comfortable using bleeding edge software. Do not upgrade to a new version without adequate time to test it before a performance.
List of open-source music production software

Contributing

Bug tracker hosted on Github
Internationalization: Help translate Mixxx into other languages
Source code is hosted on GitHub

Communication

Zulip chat: Ask for help, chat with users and developers. Native apps can be downloaded from Zulip's website and configured to use the server mixxx.zulipchat.com, or use the web app.
Forums: Ask for help, listen to and share mixes, download and share controller mappings and skins
mixxx-devel email list. Note that most project communication is on Zulip now, so you are more likely to get an answer to a question there.

Controller Mapping Documentation

MIDI controller mapping file format: create or change a MIDI mapping file for your controller
MIDI crash course
Reverse engineering tips for DJ hardware
Controller scripting with JavaScript: map advanced behaviors including jog wheel scratching, modifier (shift) buttons, and deck toggle buttons
Components JS: JavaScript library to help with writing mapping scripts
Contributing mappings: describes how to get your mapping included in Mixxx
Controller mapping file locations
Updating controller mappings: how to adapt old mappings for the latest version of Mixxx
HID & USB Bulk controller mappings: create or change a mapping for your HID or USB bulk-transfer mode controller
Mixxx Controls: List of Mixxx's controls that can be manipulated by controller mappings
Controller Engine versions
Controller mapping forum: search for mappings, share your mappings, and ask for help