Hello and thanks for downloading Herrie!

This document will discuss a small set of subjects that will help you
install and use Herrie, but also ways to contact the developers to
report bugs and such.

- What is Herrie?
- How should I pronounce it?
- What kind of platforms will it run on?
- What are the dependencies of Herrie?
- How do I compile and install Herrie?
- I've installed it - now what?
- How do I contact you (report bugs, ask questions, etc)?

What is Herrie?
~~~~~~~~~~~~~~~
Herrie is a minimalistic music player that uses the command line. It is
written to support a variety of operating systems, audio subsystems and
file formats, including playlists.

Herrie has a split-screen user interface, with a playlist at the top of
the screen and a file browser at the bottom. When tracks are added to
the playlist, Herrie automatically consumes them one by one. It is thus
an application that allows you to batch music for playback.

How should I pronounce it?
~~~~~~~~~~~~~~~~~~~~~~~~~~
Herrie is actually a Dutch word. Its meaning is similar to the English
word 'clamor' (loud noise). Just pronounce it as the English given name
'Harry' and you are a long way.

What kind of platforms will it run on?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Herrie should compile without a flaw on the following operating systems:

- Cygwin
- FreeBSD
- Linux
- Mac OS X (Darwin)
- NetBSD
- OpenBSD
- Solaris

The application has been tested on little and big endian platforms, so
the chances are high it should just work on your obscure hardware as
well. At least Intel x86, SPARC and PowerPC should work.

What are the dependencies of Herrie?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Herrie is written in C and uses a lot of functions found in the GLib
library. It also uses some libraries for audio decompression and such.
Below is a list of libraries you should install prior to compiling
Herrie:

- gettext
- glib
- libao (optional)
- libcurl
- libid3tag
- libmad
- libmodplug
- libsdl (audio - optional)
- libsndfile
- libvorbisfile
- ncurses or pdcurses (`XCurses')
- openssl

Please note that some dependencies can be disabled. OpenSSL and cURL are only
needed when compiling with AudioScrobbler or HTTP support. LibAO and SDL are
only needed when building the `ao' or `sdl' audio output driver.

How do I compile and install Herrie?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Herrie ships with a shellscript called `configure' which generates a
Makefile for your specific system. Arguments can be passed to the
configure script to change certain parameters:

- no_http       Disable support for HTTP audio streams
- no_modplug    Disable libmodplug linkage
- no_mp3        Disable MP3 audio file support
- no_scrobbler  Disable AudioScrobbler support
- no_sndfile    Disable libsndfile linkage (Wave/FLAC support)
- no_trans      Disable translations
- no_vorbis     Disable Ogg Vorbis support

- ao            Use libao audio output
- oss           Use Open Sound System output
- null          Use placeholder audio output
- sdl           Use LibSDL audio output

- xcurses       Build application against XCurses (PDCurses)

There are also some environment variables which also have influence on
the generated Makefile:

- CC            C compiler
- CFLAGS        Prepend compiler flags
- LDFLAGS       Prepend linkage flags
- CONFDIR       Change configuration file directory
- MANDIR        Change Manual page directory
- OS            Override operating system detection (for cross compilation)
- PREFIX	Change installation prefix

After running `./configure', a simple 'make; make install' will suffice.
When the DESTROOT variable is set during installation, its contents will
be prepended to the PREFIX.

I've installed it - now what?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Herrie also comes with a manual page. The manual page contains some more
information about its basic usage and a list of configuration file
switches and keyboard bindings. Please take a look at it.

How do I contact you (report bugs, ask questions, etc)?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When something goes wrong or when you have something to tell us, you can
contact us on IRC, but also by email. Please visit our website to obtain
more information on how to contact us:

	http://g-rave.nl/projects/herrie/
