Building on OS X

The recommended way to build SeriesMarker is by using MacPorts.

Prerequisites

To build SeriesMarker, and its dependencies, MacPorts requires an installed copy of Xcode, which can be found in the Mac App Store on your system for free. It also requires the Command Line Tools. More information can be found at Installing MacPorts.

Note

It is not sufficient to install the Command Line Tools only, leaving out Xcode.

Install Dependencies

With MacPorts installed, open a shell and enter the following command to update your ports database (see the MacPorts Guide for more information):

$sudo port selfupdate

The following commands will install those of SeriesMarker’s dependencies, which are available as ports:

$sudo port install python34
$sudo port install py34-pyside
$sudo port install py34-sqlalchemy

Note

In the default configuration of MacPorts, pre-build packages are loaded where available, instead of building them from source.

The commands mentioned above will also install all necessary make-dependencies, including Qt.

By issuing the following command, the MacPorts version of pip can be installed and, with it, the remaining dependencies as well:

$sudo port install py34-pip
$sudo pip-3.4 install pytvdbapi
$sudo pip-3.4 install appdirs

Install SeriesMarker

The following command will fetch the latest source distribution from the SeriesMarker Package Site, build, and install the application.

$sudo pip-3.4 install --no-deps SeriesMarker

Note

Due to the mix of installation methods, some packages are not being recognized correctly by pip. The parameter --no-deps prevents it from re-building SeriesMarker’s dependencies, which have been installed beforehand.

The location of the SeriesMarker executable is displayed at the end of the install process by pip, e.g.:

/opt/local/Library/Frameworks/Python.framework/Versions/3.4/bin/seriesmarker

SeriesMarker can now be started from within a shell at this path. You may want to create a shortcut to the executable for your convenience, e.g., in your applications directory:

$ln -s /opt/local/Library/Frameworks/Python.framework/Versions/3.4/bin/seriesmarker /Applications/SeriesMarker

You may now continue with the User Guide or explore the software on your own.