Prerequisites

You'll need to install the XCode package first. This is a free, large (> 1 GB) set of software that installs many common Unix development utilities such as gcc and automake, needed for building Epiar on OS X. It also comes with XCode, and though this document does not utilize XCode, it is a very solid IDE for the Mac should you not prefer vim or one of the other Unix-type development editors.

Once XCode is installed, you'll need to install a number of required libraries needed for building Epiar. Most of these come in the form of "Frameworks", which are self-contained directories one places in /Library/Frameworks? which enables the special version of GCC for the Mac to recognize and configure the necessary compiler and linker flags, simply based on the name of a framework. If /Library/Frameworks?/SDL.framework/ exists, then "gcc -framework SDL" will automatically find it.

Epiar requires the following libraries apart from those included in its source base or found in the ISO C++ standard:

• libxml2 (already installed on a Mac with XCode)
• SDL (OS X framework available at libsdl.org)
• SDL_image (OS X framework available at libsdl.org)
• SDL_mixer (OS X framework available at libsdl.org)
• ftgl (available via macports, e.g. sudo port install ftgl-dev)

Checking out the Source

If you don't already have the source code, you can check out the latest development code (which should compile but doesn't always depending on development) by using git (note that git requires the git-core package installed on macports, or whichever method you prefer of installing git -- there are a few to choose from on the Mac). You can check out the source code with the command: git clone ​git://github.com/knowknowledge/Epiar . This will create a directory 'Epiar' in your current directory.

Building the Source

The following commands use the widely-used GNU autotools build system (configure, make) to build Epiar:

chmod +x ./autogen.sh
./autogen.sh
./configure
make

Then simply type ./Epiar to run!