Building Mixxx for ARM64 macOS (Apple Silicon)

building-mixxx-arm64-macos.md

Warning

These are not official build instructions. No guarantees that these will work! In particular the dependencies may change at any time and you might have to check the CI builds to find out what to install.

Note

For (unofficial) binaries and scripts that simplify this build process, check out m1xxx.

Building the dependencies

To build Mixxx for ARM64 macOS, we will need to build the dependencies including Qt 6. This can conveniently be done using vcpkg, a package manager for C++ libraries. First clone the vcpkg fork which includes the relevant patches:

git clone [email protected]:mixxxdj/vcpkg.git --branch 2.5-rel
cd vcpkg

Then bootstrap vcpkg and build/install the dependencies by running

./bootstrap-vcpkg.sh
./vcpkg install --overlay-ports overlay/ports \
                --overlay-ports overlay/osx \
                --overlay-triplets overlay/triplets \
                --host-triplet arm64-osx \
                ableton \
                benchmark \
                chromaprint \
                fdk-aac \
                ffmpeg \
                fftw3 \
                grantlee \
                gtest \
                hidapi \
                hss1394 \
                libdjinterop \
                libebur128 \
                libflac \
                libkeyfinder \
                libmodplug \
                libogg \
                libopusenc \
                'libsndfile[core]' \
                libusb \
                libvorbis \
                lilv \
                mp3lame \
                ms-gsl \
                opus \
                opusfile \
                'portaudio[asio]' \
                portmidi \
                protobuf \
                pthreads \
                qt5compat \
                qtbase \
                qtdeclarative \
                qtsvg \
                qttranslations \
                qtkeychain-qt6 \
                rubberband \
                soundtouch \
                taglib \
                wavpack

Building Mixxx

To build Mixxx, clone the repo by running

git clone [email protected]:mixxxdj/mixxx.git
cd mixxx

Finally, build Mixxx with

cmake -B build -DCMAKE_TOOLCHAIN_FILE=[path/to/cloned/vcpkg]/scripts/buildsystems/vcpkg.cmake
cmake --build build

I had to change qtkeychain-qt5 to qtkeychain in the above.