$OpenBSD: README,v 1.1 2011/11/02 21:26:57 edd Exp $

+-----------------------------------------------------------------------
| Running hgd-0.5.3p0 on OpenBSD
+-----------------------------------------------------------------------

Running a Server
================

All commands shown here are run as root.

Prepare the Server
------------------

First you should create the SQLite database (which needs to be owned by
the _hgd user):
  /usr/local/sbin/hgd-admin db-init && chown _hgd /var/hgd/*

Next you should add users. For each user you would run:
  /usr/local/sbin/hgd-admin user-add <username>

Users can be promoted to admins:
  /usr/local/sbin/hgd-admin user-mkadmin <username>

Start the Server
----------------

Start hgd_netd and hgd_playd using the standard rc.d procedures:
  /etc/rc.d/hgd_netd start && /etc/rc.d/hgd_playd start

Check everything went OK:
  /usr/local/sbin/hgd-admin status

Using the HGD Client
====================

You can (for example) queue a track like this:
  hgdc -u <username> q <some_media_file>

See the manual pages for more information.

Miscellaneous Notes
===================

* Both the client and server are configurable using a config file. See the
  example config files and manual pages for details.

* If you use aucat, remember that the _hgd user must have access to the aucat
  socket.
