HGD-PLAYD(1)

NAME
hgd-playd - Player daemon for the Hackathon Gunther Daemon.

SYNOPSIS
hgd-playd [-BChpqv] [-c config] [-d state-dir] [-x debug-level]

DESCRIPTION
hgd-playd is the player daemon for the Hackathon Gunther Daemon; a music system suitable for hackathons, internet cafes, LAN parties etc.

hgd-playd plays uploaded files from clients, as described in an sqlite3 database in the state directory. hgd-playd uses mplayer(1) for multimedia playing capabilities and will play both audio files and video files (if DISPLAY is set).

The options are as follows:

-B  Do not daemonise, remain in foreground.

-c config
    Location of the config file.

-C  Clear the playlist at startup.

-d dir
    Set the HGD state directory where the SQLite database and uploaded files will be stored. This defaults to /var/hgd.

-h  Show the usage help and exit.

-p  Don't purge finished tracks from the filesystem (files/ in state dir).

-q  Don't purge finished tracks from the sqlite3 database.

-v  Show version information and exit.

-x level
    Set the debug level: 0=errors, 1=warnings, 2=info, 3=debug. Defaults to 1.

FILES
hgd-playd can read it's settings from a config file. The following locations (in the order shown) are searched:

1.  A path specified by '-c' (if given).
2.  ~/.config/hgd/hgd.rc
3.  /etc/hgd/hgd.rc

The first config file found is used. If no config file is found, default settings are used.

Sample config files are supplied in the source tarball and should be supplied by binary packagers.

HISTORY
HGD was inspired by the LPD hack -- a music system used at OpenBSD hackathons.

AUTHORS
-nosplit hgd-playd was written by Edd Barrett <vext01@gmail.com>, and Martin Ellis <ellism88@gmail.com>.

BUGS
Probably.