libtagedit installation instructions
====================================

0. Unpack the source tarball and change into the created directory

1. The dependencies:
In order to compile all plugins for libtagedit, you will need:

- libogg, libvorbis and libvorbis
    If you are using an rpm based distribution, install the *-devel
    packages for those three libraries. On debian, do
    # apt-get install libvorbis-dev
    this should trigger all other dependencies. If configure can
    not find these libraries, you will not have Ogg Vorbis support

- libFLAC and libFLAC++
    Here, the same as for Ogg Vorbis applies. According to your
    distribution package management, install the development
    files (libflac++-dev will do the job for Debian), if you want
    FLAC support

- pkg-config
    By now, Ogg Vorbis is detected via pkg-config. If you know that
    you have installed the devel packages and still configure fails,
    please write me a message and I will adapt the build system.

2. The magic triple:
To check all the dependencies and create the makefiles, simply do:

$ ./configure
If everything goes well, you can build and install the library by
$ make
and then
$ make install
you might need root privileges for that, according to the prefix you
choose (default is /usr/local

3. The Python bindings

3.1 Dependencies:
- Python 2.3 and its devel packages
- sip v4 (module, headers and the code generator)
   You can obtain it from
  http://www.riverbankcomputing.co.uk/sip/index.php
  Note that if you have to build it manually, Qt support is not
  needed (might save you some struggle)

3.2 Building & installing
First, do
$ cd python-bindings
For configuring, execute
$ python configure.py
If everything works out well, you get the following input:

> Generating the C++ source for the _tageditor module...
> Creating the Makefile for the _tageditor module...
> Creating top level Makefile...

Then build the software by the well-known command
$ make
and install it by
$ make install
Once again, check your privileges.

3.3 Trying out:
If you installed libtagedit in /usr/local, you might want to
update the dynamic linker cache by executing
# ldconfig
as root. Then, start a python interpreter
$ python
and type in the following code:
>>> import tageditor
>>> print tageditor.tagEditorExts()

According to the plugins you have compiled, you will now get a
list of supported file extensions, which should at least look like
"['.mp3']". Now you are ready. To get more introduction to the
Python module, read README.Python or python-bindings/tageditor.py.

Have fun!

Copyright (c) 2001-2004 Torsten Marek <shlomme@gmx.net>
