Compiling Mixxx for Mac OS X is a simple process once you have all dependencies and Qt set up properly. This guide assumes you have basic knowledge about using and compiling with the command line (eg: ./configure, make). If you don’t, there is a basic guide available at http://www.ee.surrey.ac.uk/Teaching/Unix/unix7.html.
Launch the Terminal application, and type the following command string:
Click Install on the software update popup window that will appear, and wait for the download and installation to finish (about 150 MB). It gets placed in the following directory:
Note: If Xcode is already installed in your system, then Command Line Tools become installed as well (you can check this by trying to run gcc or make from the terminal). To install the latest available version of Xcode for your Mac OS X release, go to https://developer.apple.com/download/. Downloading it requires a free registration at Apple's developer site.
This is the preferred method of compiling Mixxx on OS X
Homebrew is yet another package manager for OS X. It is growing quickly in popularity. Assuming you have already installed Homebrew and gotten it working:
brew install scons pkg-config portaudio libsndfile libogg libvorbis portmidi git taglib libshout protobuf flac libjpeg qt5 chromaprint rubberband fftw vamp-plugin-sdk opusfile lilv
If you will be compiling with Qt4, also run:
brew tap cartr/qt4 brew tap-pin cartr/qt4 brew install [email protected]
OPTIONAL: To enable libmodplug based module tracker support.
brew install libmodplug
If you get the error
No available formula for libmodplug , enter the following:
brew create http://sourceforge.net/projects/modplug-xmms/files/latest/download
Enter Formula name
libmodplug if asked for, then enter:
brew install libmodplug
OPTIONAL: Mixxx supports using OSX-provided versions of the MP3 and AAC codec. If you don't want to use the OSX versions of these codecs you can build the codecs into Mixxx directly. To do this, you have to install the MP3 and AAC codecs using Homebrew:
brew install libid3tag libmad mp4v2 faad2
Mixxx relies on several external libraries for various features. Fortunately, you can automatically download and install most of these dependencies through MacPorts. MacPorts is a package management system that simplifies the installation of software on Mac OS X.
sudo port install scons libid3tag libmad portaudio libsndfile libogg libvorbis mp4v2 portmidi faad2 git taglib libshout2 protobuf-cpp
After installing MacPorts, using MacPorts to install the required libraries is a simple process. Using the command
sudo port install X, where X is the name of each library you’ll need, MacPorts will automatically download and install the required dependencies. This can be done one at time by entering single entries like
sudo port install scons for each library listed above or all at once by entering the entire command given above.
Note that if you attempt to install everything at once and an error occurs in installation of a library, MacPorts will not continue past the library that caused the error. For example, if after entering the full command you receive an error with
git, you’ll need to sort out the error and then finish the installation by entering
sudo port install git taglib libshout2 to properly install
git and then continue with installing
If a library already happens to be installed on your computer, that's a time-saver, and you'll see something similar to this:
~/Music/mixxx>sudo port install libmad Skipping org.macports.activate (libmad ) since this port is already active ---> Cleaning libmad
Otherwise, MacPorts will automatically install the library and you'll see something similar to this:
~/Music/mixxx>sudo port install libid3tag Password: ---> Fetching libid3tag ---> Attempting to fetch libid3tag-0.15.1b.tar.gz from ftp://ftp.mars.org/pub/mpeg/ ---> Verifying checksum(s) for libid3tag ---> Extracting libid3tag ---> Configuring libid3tag ---> Building libid3tag with target all ---> Staging libid3tag into destroot ---> Installing libid3tag 0.15.1b_0 ---> Activating libid3tag 0.15.1b_0 ---> Cleaning libid3tag
Note that the password asked for is an admin password for your local machine. This is because you are going into super-user mode in order to write the libraries to your hard drive. It's basically a safe operation, but they put it behind a password so the area where the libraries are stored doesn't get touched very often.
If you get a message like this:
Error: Target org.macports.fetch returned: fetch failed
It probably means that the config file for port hasn't been updated. Perhaps there has been a newer version of the library released. You may be hosed at this point, but if you have an older version of the library already installed on your system, it may still compile and run properly.
You will need to install the following by hand for the compile process:
If you want to compile Mixxx, you'll need to download the source code. Either grab the source for the latest release off our downloads page, or checkout the latest Mixxx code from our Git repository. Refer to Using Git for more details.
If you used Homebrew, you need to set your compiler paths accordingly. In the below code you should customize
HOMEBREW_PATH to the path where your Homebrew folder can be found. Copy and paste the code below into ~/.bash_profile:
HOMEBREW_PATH=/usr/local # See the note below about the Opus workaround. export CFLAGS="-I$HOMEBREW_PATH/include -I$HOMEBREW_PATH/include/opus" export CXXFLAGS="-I$HOMEBREW_PATH/include -I$HOMEBREW_PATH/include/opus" export LDFLAGS=-L$HOMEBREW_PATH/lib export QTDIR=$HOMEBREW_PATH/Cellar/qt/%VERSION%/
Opus Workaround: The version of libopus included with Homebrew has a bug where opusfile.h includes the file opus_multistream.h. In order for this file to be present on the include path, we need to add $HOMEBREW_PATH/include/opus to the include path. This will hopefully be fixed in future versions of libopusfile.
QTDIR will tell scons where to find your Qt installation. Replace %VERSION% with the folder name, e.g. 5.10.1 . Run
brew list --versions qt
to see what version(s) you have installed.
Change to the newly created
mixxx directory, and use scons to compile and install:
cd mixxx scons stdlib=libc++ hss1394=0 mad=0 faad=0 coreaudio=1 verbose=0 qt5=1 scons bundle
If you are compiling with Qt4, replace
qtdir=/usr/local/Cellar/[email protected]/%VERSION%/. Replace %VERSION% with the folder name, e.g. 4.8.7_5 . Run
brew list --versions [email protected]
to see what version(s) you have installed.
This should generate
Mixxx.app which you can run by double-clicking on or typing
open Mixxx.app. Generating the .app has some expensive scanning and relinking steps so if you want to avoid this you can skip
scons bundle and instead on the first run of Mixxx run it as:
./mixxx --resourcePath res/
So that it records res/ in mixxx.cfg as where to find skins, controller mappings, and other resources instead of dying at startup.
The GCC wrapper around Clang on OS X tries to behave like GCC which loses some of these benefits. To use Clang directly, before running
export CC=clang export CXX=clang++
You can now use clang-specific SCons options.
As of v1.12, Mixxx will use CoreAudio to decode MP3 and AAC files by default. If you want to use
libfaad for MP3 and AAC decoding, simply set the
faad flags and clear the
coreaudio flag. To enable libmodplug based module tracker support, set the
modplug flag. For example:
scons hss1394=0 mad=1 faad=1 coreaudio=0 modplug=1 verbose=0
OSX 10.9 Mavericks has changed the stdlib default to libc++. If you are on OSX 10.9 Mavericks and get this link error, try the “scons” command above like this:
If you installed Qt to a custom location you will have to provide this via the
qtdir flag. For example, you could try:
Because /Developer is a common place for Qt to drop its frameworks.
This most likely means you are building Mixxx with libstdc++ and not libc++. Mixxx versions newer than 2.0 now require C++11 so libstdc++ is no longer an option since it does not support C++11 features like initializer_list.
Try the “scons” command above like this:
If you want to work on Mixxx with XCode for an IDE:
This is taken from the Scons site, who have a pretty good description of how to get a scons project up and running in XCode: