First, download the source code here or from the sourceforge page.
Aria is written in C++. To build it from source, you will need to install wxWidgets. I am currently using 2.8.x.
Aria also uses these, however you do not need to download and install them yourself because they are included either in the source package or by default on every mac.
scons
OpenGL and GLUT
libjdkmidi
irrXML
(Please note that these instructions are for building with scons. You can also build with your favorite IDE/build system, but you'll then need to set up things yourself.)
Prerequisites - Mac OS X
You will need to install Developer Tools from the mac OS X install disc. You need OS X 10.4.
Prerequisites - Linux
The Linux version has been tested less than the mac one but appears to be getting more stable. At this point, you might want to build it to help me test it - it might also be stable enough for production but no promise :).
You will need Python, Alsa (including -dev packages if your distro uses them), wxGTK, OpenGL (-dev packages if any), gcc/g++ (build-essential in Ubuntu). For midi playback, you will need a softsynth like Timidity with a soundbank (more info below)
Installing wxWidgets - Mac OS X
First, download and install wxWidgets. I usually build static. Don't forget to enable OpenGL support.
Example terminal commands (read the instructions that come with wxWidgets or wxWiki for more info):
cd wxMac2.8.x
mkdir osx-build && cd osx-build
../configure --with-libjpeg=builtin --with-libpng=builtin --with-regex=builtin --with-libtiff=builtin
--with-zlib=builtin --with-expat=builtin --with-opengl --enable-unicode --disable-shared
make
sudo make install
Make sure wx-config --libs points to the 2.8 libs when run from a terminal. Mac OS X 10.4 comes with wxWidgets 2.5 pre-installed. It is not recommended to build Aria with it. If you install wxWidgets 2.8 from source, it will default to installing in /usr/local, however pre-installed 2.5 is in /usr, so be careful about conflicts. If /usr comes before /usr/local in yout PATH environment variable, you will get the 2.5 libs. For getting 2.5 out of the way quickly, just get /usr/bin/wx-config out of the way (sudo mv /usr/bin/wx-config /usr/bin/wx-config-2.5). If your computer does not find wx-config, make sure /usr/local/bin is in your PATH (or pass WXCONFIG=/usr/local/bin/wx-config to scons - see explainations below).
Installing wxWidgets - Linux
You can simply download wxWidgets 2.8 from your distribution's repositories. It needs OpenGL support enabled and to be Unicode, and don't forget to install -dev packages if your distribution uses them.
If you want to build wxWidgets from source, you can use commands like (read the instructions that come with wxWidgets or wxWiki for more info):
cd wxGTK2.8.x
mkdir gtk-build && cd gtk-build
../configure --with-opengl --enable-unicode
make
sudo make install
Make sure wx-config --libs points to the 2.8 libs when run from a terminal. If it does not, it is likely that your distribution's wxWidgets (in /usr/) is picked up before the one you built (in /usr/local/). To fix this, you can pass WXCONFIG=/usr/local/bin/wx-config to scons when building - more info below.
building libjdkmidi (any platform)
Then you need to build libjdkmidi - its source is included with Aria however it is built seperately.
cd /path/to/Aria/Src
cd libjdkmidi
make
cd ..
Compiling Aria (any platform)
You are now ready to build Aria itself. All you need to do is type the command appropriate for your system :
Note: if you are building from the source archive, you do not need to install scons. Simply replace any occurence of scons in the commands below with python scons/scons.py.
scons
This will do a release build.
You can specify release=[debug/release] for different build styles if you wish. You can also pass WXCONFIG=/path/to/wx-config to specify what wx-config to use when building (wx-config is what tells the build system where are the wxWidgets headers and libraries).
Finishing on OS X
You can make a mac OS X app bundle with the following command:
scons install
Finishing on Linux
At this point, if you are happy with letting Aria live in this folder, you can simply run it with ./Aria
You can also install Aria into /usr/local/ by running the following command as root :
scons install
or, to specify an install prefix :
scons install prefix=/usr/
You can uninstall it later if you want with
scons uninstall prefix=/usr
Don't forget to specify the prefix it was installed into if it is not the default one.
If it is not already the case, you will need to install a softsynth like Timidity configured with flags : ./configure --enable-audio=alsa --enable-server --enable-alsaseq
and a soundbank, and run it as Alsa daemon with commands (in the case of Timidity) :
sudo modprobe snd-seq-midi
sudo timidity -iA -B2,8 -Os -EFreverb=0
-EFreverb=0 disables reverbering because it tends to cause problems, but you can leave that part out if you computer is very fast.
Then, to open Aria, type Aria in a terminal - enjoy!
If you have any question or issue, do not hesitate to contact me!