HGD-ADMIN(1)

NAME
hgd-admin - Administration program for the Hackathon Gunther Daemon.

SYNOPSIS
hgd-admin [-hv] [-d dir] [-x debug-level] Command Args

DESCRIPTION
hgd-admin is an administration program for the Hackathon Gunther Daemon; a music system suitable for hackathons, internet cafes, LAN parties etc.

The options are as follows:

-d dir
    Set the path to the HGD state directory.

-h  Show the usage help and exit.

-v  Show version information and exit.

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

The commands are as follows:

db-init
    Delete any existing database and make a fresh one.

pause
    Toggle pause.

skip
    Skip current track.

status
    Show the status of the HGD daemons.

user-add user [pass]
    Add a user to the system. The password parameter is optional; if no password is given, hgd-admin will prompt for one.

user-del user
    Delete a user from the system.

user-list
    List users in the system.

user-mkadmin user
    Set the admin flag on this user. This allows them to (for example) skip tracks.

user-noadmin user
    Revoke the admin flag on this user.

FILES
hgd-admin 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-admin was written by Edd Barrett <vext01@gmail.com>, and Martin Ellis <ellism88@gmail.com>.

BUGS
Probably.