Command Line Options
Mixxx is designed to be as user-friendly as possible. As such, its command line options are only useful for development or debugging. Below is an exhaustive list.
Since 1.11, command line options are part of the manual - the latest version is always here: https://mixxx.org/manual/latest/chapters/appendix.html#command-line-options
By replacing "latest" in the url with the desired version (e.g. 2.2 or 1.11), you will be guided to the respective documentation for that version
These are case-sensitive
You can load supported sound files directly into the virtual decks by specifying them at the command line.
| Option | Description | Code location |
|---|---|---|
filename |
Loads the specified music file at start-up (of the types Mixxx supports.) Each file you specify will be loaded into the next deck. | |
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as controller presets, overriding the default installation location | configobject.cpp |
--pluginPath path |
Top-level directory where Mixxx should look for for sound source plugins in addition to default locations | soundsourceproxy.cpp |
--settingsPath path |
Top-level directory where Mixxx should look for settings. | |
--controllerDebug |
Causes Mixxx to display/log all of the MIDI/HID/etc. messages it receives and script functions it loads | |
--developer |
Enables developer-mode. Includes extra log info, stats on performance, and a Developer tools menu. | |
--safeMode |
Enables safe-mode. Disables OpenGL waveforms, and spinning vinyl widgets. Try this option if Mixxx is crashing on startup. | |
--locale LOCALE |
Use a custom locale for loading translations (e.g 'fr') | main.cpp |
--f, --fullScreen
|
Causes Mixxx to start in full-screen mode | main.cpp |
--logLevel LEVEL |
Sets the verbosity of command line logging. Levels: | |
criticalCritical/Fatal only |
||
warning Above + Warnings |
||
info Above + Informational messages |
||
debug Above + Debug/Developer messages |
||
trace Above + Profiling messages |
||
--logFlushLevel LEVEL |
Sets the the logging level at which the log buffer is flushed to mixxx.log. LEVEL is one of the values defined at --logLevel above. | |
--debugAssertBreak |
Breaks (SIGINT) Mixxx, if a DEBUG_ASSERT evaluates to false. Under a debugger you can continue afterwards. This will also avoid to switch the MIXXX_DEBUG_ASSERTIONS_FATAL flag which leads to a time consuming full rebuild. Now the MIXXX_DEBUG_ASSERTIONS_FATAL is only respected if --debugAssertBreak is not passed. | |
--h, --help
|
Displays all current command line options | main.cpp |
You can load supported sound files directly into the virtual decks by specifying them at the command line.
| Option | Description | Code location |
|---|---|---|
filename |
Loads the specified music file at start-up (of the types Mixxx supports.) Each file you specify will be loaded into the next deck. | |
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as controller presets, overriding the default installation location | configobject.cpp, line |
--pluginPath path |
Top-level directory where Mixxx should look for for sound source plugins in addition to default locations | soundsourceproxy.cpp, line |
--settingsPath path |
Top-level directory where Mixxx should look for settings. | |
--controllerDebug |
Causes Mixxx to display/log all of the MIDI/HID/etc. messages it receives and script functions it loads | |
--developer |
Enables developer-mode. Includes extra log info, stats on performance, and a Developer tools menu. | |
--safeMode |
Enables safe-mode. Disables OpenGL waveforms, and spinning vinyl widgets. Try this option if Mixxx is crashing on startup. | |
--locale LOCALE |
Use a custom locale for loading translations (e.g 'fr') | main.cpp, line |
--f, --fullScreen
|
Causes Mixxx to start in full-screen mode | main.cpp, line |
--h, --help
|
Displays all current command line options | main.cpp, line |
You can load supported sound files directly into the virtual decks by specifying them at the command line.
| Option | Description | Code location |
|---|---|---|
filename |
Loads the specified music file at start-up (of the types Mixxx supports.) Each file you specify will be loaded into the next deck. | |
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as controller presets, overriding the default installation location | configobject.cpp, line |
--pluginPath path |
Top-level directory where Mixxx should look for for sound source plugins in addition to default locations | soundsourceproxy.cpp, line |
--settingsPath path |
Top-level directory where Mixxx should look for settings. | |
--controllerDebug |
Causes Mixxx to display/log all of the MIDI/HID/etc. messages it receives and script functions it loads | |
--locale LOCALE |
Use a custom locale for loading translations (e.g 'fr') | main.cpp, line |
--developer |
Enables a Developer menu item in the menu bar | |
--f, --fullScreen
|
Causes Mixxx to start in full-screen mode | main.cpp, line |
--h, --help
|
Displays all current command line options | main.cpp, line |
You can load supported sound files directly into the virtual decks by specifying them at the command line.
| Option | Description | Code location |
|---|---|---|
filename |
Loads the specified music file at start-up (of the types Mixxx supports.) Each file you specify will be loaded into the next deck. | main.cpp, line FIXME |
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as MIDI mappings, overriding the default installation location | configobject.cpp, line 326 |
--pluginPath path |
Top-level directory where Mixxx should look for for sound source plugins in addition to default locations | soundsourceproxy.cpp, line 78 |
--midiDebug |
Causes Mixxx to display/log all of the MIDI messages it receives and script functions it loads | mididevice.cpp, line 52 |
--locale LOCALE |
Use a custom locale for loading translations (e.g 'fr') | main.cpp, line 229 |
--f, --fullScreen
|
Causes Mixxx to start in full-screen mode | main.cpp, line 227 |
--h, --help
|
Displays all current command line options | main.cpp, line 183 |
You can load supported sound files directly into the virtual decks by specifying them at the command line.
| Option | Description | Code location |
|---|---|---|
filename |
Loads the specified music file at start-up (of the types Mixxx supports.) Each file you specify will be loaded into the next deck. | main.cpp, line 281 |
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as MIDI mappings, overriding the default installation location | configobject.cpp, line 310 |
--midiDebug |
Causes Mixxx to display/log all of the MIDI messages it receives and script functions it loads | mididevice.cpp, line 52 |
--f, --fullScreen
|
Causes Mixxx to start in full-screen mode | main.cpp, line 276 |
--h, --help
|
Displays all current command line options | main.cpp, line 249 |
| Option | Description | Code location |
|---|---|---|
--resourcePath path |
Top-level directory where Mixxx should look for its resource files such as MIDI mappings, overriding the default installation location | configobject.cpp, line 301 |
--loadXMLfile /path/to/mapping.midi.xml |
Forces Mixxx to load the specified MIDI mapping on start-up instead of the last-used ''MixxxMIDIBindings.xml` | midimapping.cpp, line 396 |
--midiDebug |
Causes Mixxx to display/log all of the MIDI messages it receives //(Windows only, >=1.7.1)// | midiobjectwin.cpp, line 27 |
This is the Mixxx Wiki - 
Mixxx is a free and open-source DJ software.
Manual
Hardware Compatibility
Reporting Bugs
Getting Involved
Contribution Guidelines
Coding Guidelines
Using Git
Developer Guide
Creating Skins
Contributing Mappings
Mixxx Controls
MIDI Scripting
Components JS
HID Scripting