MusicBrainz Picard Install Instructions
---------------------------------------------------

OS Support: 

    Linux: Works.
    Windows: Works.
    Mac: Has many horrible bugs due to wxWindows. :-(

Prerequisites:

(Please don't ask for help if you're not will to install *ALL* the
 prerequisites!)

1. Python 2.4

    If you don't have Python 2.4 installed, grab it from http://python.org

2. wxPython 2.6.1.x or higher UNICODE version

    Grab wxPython from http://wxpython.org/download.php#binaries 

    Make sure you get the UNICODE version -- if you don't the tagger won't run.
    If your distribution doesn't provide packages for 2.6.1.x/UNICODE, you'll
    have to compile it yourself -- I've created a script that allows me to
    compile picard in one easy step:

       http://musicbrainz.org/~robert/build_wx.sh

    Be sure to take a look at the build script and change the version number
    or install paths. I use a non-standard /opt install path to not conflict
    with the normal wxWidgets/wxPython install. In order to run the tagger
    using the wxPython install from the /opt install path, start it with a
    script like this:

       #!/bin/sh
       export LD_LIBRARY_PATH=/opt/wx/2.6.1.0/lib
       export PYTHONPATH=/opt/wx/2.6.1.0/wxPython
       python tagger.py 

    Again, adjust paths as necessary.

3. python-musicbrainz2 and ctypes

    Download and install the new MusicBrainz python client library from:

       http://wiki.musicbrainz.org/PythonMusicBrainz2

    You'll also need the ctypes (0.9.6 or higher) package:

       http://sourceforge.net/project/showfiles.php?group_id=71702

4. libdiscid (optional)

    In order do enable CD lookups, you will need to install also libdiscid:

       http://musicbrainz.org/doc/libdiscid

    Follow the instructions in INSTALL

5. libtunepimp

    Install this version of libtunepimp:

       ftp://ftp.musicbrainz.org/pub/musicbrainz/libtunepimp-0.5.2.tar.gz

    Follow the instructions in INSTALL

6. libtunepimp python bindings

    In the python directory of libtunepimp (downloaded from above) are the
    python tunepimp bindings. After installing libtunepimp, do this from the
    python directory:

       $ sudo python setup.py install

7. Once you've installed this long list of software packages, run the tagger
   from this directory:

       $ ./tagger.py
       
   or install it system-wide:
   
       $ sudo python setup.py install
       $ picard

8. Read the README file to get a clue how to use it and to let me know about
   problems in the tagger.

More detailed instructions on how to install Picard can be found on
MusicBrainz wiki: http://wiki.musicbrainz.org/PicardSourceInstall,
http://wiki.musicbrainz.org/PicardLinuxInstall

Good luck!
