.\"
.\" Copyright (c) 2006-2007 Ed Schouten <ed@fxq.nl>
.\" All rights reserved.
.\" 
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.TH HERRIE 1 "June 3, 2007" "Ed Schouten"
.SH NAME
herrie \- interactive music playlist player
.SH SYNOPSIS
.B herrie
.RB [ -vx ]
.RB [ -c
.IR configfile ] 
.RI [ file
.IR ... ]
.SH DESCRIPTION
.B herrie
is a command line music player. It supports multiple audio file formats
(including MP3 and Ogg Vorbis) and has the ability to send playback
statistics to AudioScrobbler. The word `herrie' is Dutch for `clamour'.
.PP
.B herrie
uses a split-screen user interface: a playlist at the top and a
filebrowser at the bottom. The application has two modes of operation,
called `party mode' and `XMMS mode'. When the application is started in
party mode, the first song in the playlist gets started. It will also be
removed from the playlist as well. When the application is started in
XMMS mode, any song can be started and will not be removed from the
playlist.  The default mode is party mode.
.PP
The following command line options are available:
.TP
.BI "-c " "configfile"
By default,
.B herrie
searches in
.I ~/.herrie/config
or in the system wide global configuration file
.I %%CONFFILE%%
for options. The
.B -c
options allows you to load additional configuration files.
.TP
.B -v
Display version information and a list of supported file formats.
.TP
.B -x
This switch causes
.B herrie
to start up in XMMS mode.
.PP
Files that are passed on the command line will be appended to the
playlist.
.SH CONFIGURATION SWITCHES
.b herrie
may be configured by storing options in a configuration file. Options
must be stored in the following format:
.TP
.B key=value
.PP
Below is a list of switches, including their default values:
