This directory contains code for other UBS modules which are not included with the default installation.  The reason for this is either the module is not necessary for the core functionality of the UBS, and will generally not be required for most site configurations.  To build any of the events for the UBS, simply run "make event" in this directory (or run "make", to build all events), where 'event' refers to:

- pick_song: This event will choose a random song from a given directory, and place the filename in tmp/next-event under the UBS prefix.  Upon receiving an event signal, the ubs-play daemon is configured to read and play whatever file is referenced here.  This is useful for station ID's, public service annoucements, and other such things.  This event does NOT do any log back checking, so it is possible for it to select the same file to be played two times in a row.  This event also has its own context within ubs.conf, which is the same name as whatever the program name is.  That is, multiple copies of this event can be placed in the UBS bin/ directory, and all given different filenames (for example, this event can be installed as "pick_song", and then copied to be "pick_stationid" and "pick_psa".  In this event, "pick_stationid" and "pick_psa" are both recognized as separate contexts within ubs.conf, even though they are functionally working with the same binary file).  For each context, the following directives are recognized within ubs.conf:
  * dir: The directory to pick a song from.
