Home

Welcome to the Mixxx Wiki!

Mixxx has an unusually broad community for an open-source project, encompassing performing musicians, C++ addicts, amateur DJs, Internet radio broadcasters, and casual users. The Mixxx Wiki contains useful information for users, developers, and artists, and is summarized in the categories below.

Some pages have translations available. You can read them by clicking the language icon at the bottom of a page.

Most of the contents of this wiki can be edited by anyone, the main exception to this is the development roadmap which is a fairly authoritative description of the development team's plans. If you find outdated, incorrect, or incomplete information on this wiki, please fix it.

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.

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.
Blog
List of open-source music production software

Contributing

Bug tracker hosted on Launchpad
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