VMPC2000XL has migrated away from Conan and now fully relies on CMake for including and maintaining dependencies. I'll add a README to vmpc-juce, but building from source should be very simple now:
$ git clone https://github.com/izzyreal/vmpc-juce
$ mkdir build && cd build
$ cmake .. # Optionally with '-G "Xcode"' or similar if you want to edit VMPC2000XL in an IDE
$ make vmpc2000xl_All -j 8You are interested in
- contributing to VMPC2000XL
- building VMPC2000XL for specific platforms/environments
- exploring music and audio source code
- C++ IDE workspace creation (Xcode/Visual Studio) with Conan
- C++ build automation and package management with Conan
Requirements:
Once you have these tools installed, run the following commands:
conan remote add jfrog-izmar https://izmar.jfrog.io/artifactory/api/conan/dev
git clone https://github.com/izzyreal/vmpc-workspace
cd vmpc-workspace
If you want to use Visual Studio and build 64 bit binaries, run
python build.py vs
or for a 32 bit Visual Studio build
python build.py vs32
and for Xcode
python build.py xcode
If you want just the IDE workspace/project files without building the binaries immediately, use python build-workspace.py ....
There are some more generators available. Run python build.py to see them all. The ninja and make generators are used by after executing build.py going into the vmpc-workspace/build dir and running make help or ninja help to see the available targets.
For Xcode and VS, open the solution or project in vmpc-workspace/build and you're good to go. There are Release and Debug configs. Both IDEs will default to the Debug config.
The aim of vmpc-workspace is to give you everything that you need to create an IDE project/solution/workspace for navigating, building and contributing to the VMPC2000XL source code.
It is also the main way to build binaries for your platform if they are not provided on https://www.izmar.nl/index.php/downloads.
If you simply want to use VMPC2000XL and need the installer, see https://www.izmar.nl/index.php/downloads for precompiled binaries.
vmpc-juce is a runnable GUI implementation of mpc, based on JUCE6. The root of the workspace, and thus of the dependency tree, vmpc-juce is where the main application's executable lives. vmpc depends on mpc, ctoot and moduru (and some 3rd party transitive dependencies that are beyond the scope of this readme).
mpc compiles to a static library that covers most of the Akai MPC problem domain. The MPC's core functionalities are:
- sequencing, musical arrangement
- sample record and playback
The library is agnostic to GUI implementation, and depends on ctoot and moduru.
ctoot is a port of Steve Taylor's toot2 from Java to C++. In many areas only the bare minimum is implemented, so don't expect a full port. Most of the fundamentals of the digital audio and music problem domain is covered:
- audio system with mixer (optionally auto-connecting)
- modular configuration of inputs, outputs and other DSP processes
- audio process service discovery (for e.g. effects and synthesizers)
- delay, reverb, EQ, dynamics
- synthesis
- MIDI system (optionally auto-connecting)
akaifat implements a custom FAT16 filesystem layer that supports 16.3 filenames, like the real MPC2000XL. It is used by VMPC2000XL to mount USB volumes, like CF cards, directly into VMPC2000XL.
moduru is a collection of utilities I made, combined some easy to include 3rd party libraries that I like to use, for example libsamplerate.
Follow the Quick Start instructions above.
There are 5 main targets, and 1 test suite target for 4 of them. Note that the test suite targets are completely different from Conan's test_package directories. The latter are concerned with verifying the health of a Conan package, and verifying inclusion of headers and linked libraries. The test suites of the main targets are for unit and integration testing.
So the target list of the workspace becomes:
vmpc2000xl_Standalone(executable)mpc(static library)mpc-tests(executable)ctoot(static library)ctoot-tests(executable)akaifat(static library)akaifat-tests(executable)moduru(static library)moduru-tests(executable)
The vmpc-workspace directories vmpc-juce, mpc, ctoot, akaifat and moduru are created by successful execution of the python build script. These directories are pulled from the linked repositories.