2. Getting Started¶
2.1. Installing Mixxx¶
After downloading Mixxx from our Website, you need to install it on your computer.
Double-click the Mixxx installation file and go through the installation wizard.
Double-click the Mixxx .dmg file and drag the Mixxx icon to your Applications folder.
No steps are necessary after you follow the instructions on the download page.
2.2. Upgrading Mixxx¶
You may safely install Mixxx on top of any previous version. You don't need to uninstall the old version.
Your settings and library will not be removed or reset, but they may be upgraded when you launch the new version of Mixxx. Note that we do not guarantee that new configurations will work on older versions of Mixxx, therefore you may want to make a backup of your existing settings just in case.
Mixxx settings are in
%LOCALAPPDATA%\Mixxx, which is usually something like
c:\Users\<username>\AppData\Local\Mixxx. If you have trouble finding this folder, see these instructions.
Mixxx settings are in
Mixxx settings are in
Copy this directory to a backup drive or somewhere else on your system to make a backup of your settings.
For detailed descriptions of the settings files, go to The Mixxx Settings Directory.
2.3. Opening Mixxx¶
Once you've installed Mixxx, start by opening Mixxx and importing your music to the Mixxx library.
Double-click the Mixxx icon on the Desktop. Alternatively, browse your Windows start menu and click the Mixxx icon, or perform a search for
Double-click the Mixxx icon in the
Applicationsfolder. Alternatively, drag the Mixxx icon to the dock and double-click it there or search for mixxx in Spotlight.
Click the Mixxx icon in the applications menu or launcher of your desktop environment or perform a search for
mixxx. Alternatively type mixxx into the terminal, then hit Return. If your audio interface is not accessible from Mixxx because it is used by other applications via PulseAudio, you may close and restart Mixxx using pasuspender mixxx. See Launching Mixxx from the Command Line for an overview of Mixxx's command line options.
2.4. Importing your audio files¶
The first time you run Mixxx, you are asked to select a directory where your music is stored. By default, the dialog points to a location where music files are typically held, but you can select any location on your computer.
Click Select Folder and Mixxx will scan your music library. Depending on the size of your library this could take some time. All the supported music files Mixxx detects will be listed in the Tracks - View and edit your whole collection.
If you want to refresh your library (for example because you added or moved files), you can do this within the menu. If you want to rescan at every launch, select .
On Windows 7 and 8 the import dialog points to your Windows “Music“ Library, a special-purpose virtual folder. You can not use these virtual folders. Select a regular folder instead, usually “My Music“, like pictured above.
2.5. Analyze your library¶
Mixxx automatically analyzes tracks the first time you load them in a deck. This allows you to run beatgrid, key, and ReplayGain detection on tracks in advance. It also prepares the waveform overviews, detects file corruption, and calculates the BPM values.
For more information, go to Beat Detection.
Why you should analyze your audio files¶
If the tracks have never been played with Mixxx before, the library columns BPM, Duration and Key will be empty or unreliable (because the values are just read from the file's tags if present and might be wrong). Pre-generating beatgrids gives you the chance to double-check the beat markers to make sure they are correct. Errors in beatgrids can cause difficulty when syncing tracks. Furthermore, track analysis takes considerable CPU power and might cause skips in the audio --- things you surely don't need while performing.
How to analyze your audio files¶
Once you have imported your music library, press OK on the Preferences window.
Go to the Analyze view on the left side panel of the library.
To analyze a few specific tracks, hold down the Ctrl button, and select the tracks that you want to analyze or you can shift-select a range of tracks. Once they've been highlighted, click the Analyze button on the top right of the library section.
To analyze the newly added tracks, toggle the New label and then click Analyze.
To analyze the entire library, toggle the All label and then click Analyze.
The New and All toggle buttons are located at the top left of the analysis pane - just above the Preview and Cover Art column titles of the library.
While analyzing, the progress in percentage and total queue length are shown.
2.6. Configuring sound input and output¶
Before you can start using Mixxx, you need to configure Mixxx to use your sound hardware in. You do not need to configure all inputs and outputs.
The DJ Hardware chapter explains different types of DJ hardware and how to set them up with the input and output options. For Mixxx to perform the best it can on your system, configure the other Sound Hardware preferences in addition to the inputs and outputs.
Use these outputs if you are not using an external hardware mixer. If you are using a controller with a built-in audio interface, use these outputs.
Main: all decks, samplers, microphones, and auxiliary inputs mixed together. This output is sent to the speakers for the audience.
Headphones: all decks, samplers, microphones, and auxiliary inputs assigned to pre-fader listening
Booth: same as main output, but has a separate gain control
Decks 1-4: the individual unmixed decks to send to an external mixer
Bus Left/Center/Right: all decks, samplers, and auxiliary inputs assigned to each side of Mixxx's crossfader
Use these inputs if you are not using an external hardware mixer. If you are using a controller with a built-in audio interface, use these inputs.
Microphone 1-4: live microphone or musical instrument inputs
Auxiliary 1-4: other sound sources
Record/Broadcast: When this is configured, Mixxx will record and broadcast from this audio interface input instead of the internal main output mix. If you have a microphone plugged into the mixer, do not configure the Microphone 1-4 inputs.
Either internal or external mixing:
Vinyl Control 1-4: timecode input from turntables or CDJs for manipulating decks 1-4