User Tools

Site Tools


command_line_options

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
command_line_options [2017/06/23 08:05]
jus [2.1-alpha] Add info for ``debugAssertBreak``option, see https://github.com/mixxxdj/mixxx/pull/1189
command_line_options [2020/04/18 17:42] (current)
xerus Link to manual page
Line 1: Line 1:
 ====== Command line options ====== ====== Command line options ======
 +
 +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
 +
 +----
  
 Mixxx is designed to be as user-friendly as possible. As such, its command line options are only useful for development or debugging, as they make these tasks easier. Here is an exhaustive list: Mixxx is designed to be as user-friendly as possible. As such, its command line options are only useful for development or debugging, as they make these tasks easier. Here is an exhaustive list:
Line 5: Line 11:
 //These are case-sensitive//​ //These are case-sensitive//​
  
-===== 2.1-alpha ​=====+===== 2.1 =====
  
 You can load supported sound files directly into the virtual decks by specifying them at the command line. You can load supported sound files directly into the virtual decks by specifying them at the command line.
Line 11: Line 17:
 ^Option^Description^Code location^ ^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.| | |//​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 +|''​-''''​-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, line |+|''​-''''​-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.| | |''​-''''​-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| | |''​-''''​-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.| | |''​-''''​-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.| | |''​-''''​-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 +|''​-''''​-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, line |+|''​-f'',​ ''​-''''​-fullScreen''​|Causes Mixxx to start in full-screen mode|main.cpp|
 |''​-''''​-logLevel LEVEL''​|Sets the verbosity of command line logging |''​-''''​-logLevel LEVEL''​|Sets the verbosity of command line logging
   critical - Critical/​Fatal only   critical - Critical/​Fatal only
Line 26: Line 32:
   trace    - Above + Profiling messages   trace    - Above + Profiling messages
 | | | |
-|''​-''''​-debugAssertBreak''​|Breaks (SIGINT) Mixxx, if a DEBUG_ASSERT evaluates to false. Under a debugger you can continue afterwards.| +|''​-''''​–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.| 
-|''​-h'',​ ''​-''''​-help''​|Displays all current command line options|main.cpp, line |+|''​-''''​-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|
  
 ===== 2.0 ===== ===== 2.0 =====
Line 44: Line 51:
 |''​-f'',​ ''​-''''​-fullScreen''​|Causes Mixxx to start in full-screen mode|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 | |''​-h'',​ ''​-''''​-help''​|Displays all current command line options|main.cpp,​ line |
- 
  
  
Line 61: Line 67:
 |''​-f'',​ ''​-''''​-fullScreen''​|Causes Mixxx to start in full-screen mode|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 | |''​-h'',​ ''​-''''​-help''​|Displays all current command line options|main.cpp,​ line |
 +
 ===== 1.10 ===== ===== 1.10 =====
  
command_line_options.txt · Last modified: 2020/04/18 17:42 by xerus