INSTALLATION FROM SOURCE:

1) LINUX

First install the following dependencies:

-Python 2.5 or later (http://www.python.org)
-PyQt 4.5 or later
 (http://www.riverbankcomputing.co.uk/software/pyqt/download)
-If you want to be able to enter formulas using latex syntax, make sure
 that latex and dvipng are installed.
-Matplotlib (http://matplotlib.sourceforge.net/)
-EasyInstall (http://peak.telecommunity.com/DevCenter/EasyInstall)
-CherryPy 3.2 or later (http://www.cherrypy.org)
-Webob 1.4 or later (http://webob.org)

Under Ubuntu, these dependencies can be resolved by installing the
following packages:

python-cherrypy3 python-virtualenv python-qt4-dev pyqt4-dev-tools
qt4-designer python-qt4-sql libqt4-sql-sqlite python-matplotlib
python-qt4-phonon python-sphinx python-webob python-setuptools

To actually install mnemosyne:
-Extraxt the .tar.gz file and change to its root directory (i.e.
 probably the directory where you found this README file).
-Type 'python setup.py install' as root.

To test the installation:
-Change to any other directory e.g. by typing 'cd ~'.
-Run the application by typing 'mnemosyne'.

If you run into the issue of non-latin characters not displaying on statistic
plots, install ttf-mscorefonts-installer and regenerate the font cache of
matplotlib.

2) MAC OS/X

 - Download and install the latest version of Homebrew
 - Open the Terminal.
 - Make sure you are using the latest version of Homebrew:

    brew update

 - Install the dependencies for Mnemosyne. You'll need a few extra steps to install gdk-pixbuf to avoid a nasty error with py2app and macholib:

    brew install bzr python qt4 pyqt sip matplotlib mplayer
    brew install $(brew deps gdk-pixbuf)
    brew fetch --build-from-source gdk-pixbuf
    sed -i '' -e '/append_to_cflags/ {
      a\
      ENV.append("LDFLAGS", "-Xlinker")
      a\
      ENV.append("LDFLAGS", "-headerpad_max_install_names")
      }' /usr/local/Library/Formula/gdk-pixbuf.rb #add helpful flags
    brew install --build-from-source gdk-pixbuf
    pip install distribute==0.7.3 cherrypy==3.8.0 webob==1.5.0 virtualenvwrapper==4.7.1 virtualenv==13.1.2

 - Build it (filling in the version from the top line of "brew info qt4"):

    sudo make osx

 - Test the new application (back up your data directory first!):

    open dist/Mnemosyne.app

 - and optionally drag and drop this new app to /Applications
