This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Lars von Wedel <vonwedel@web.de>

Project's homepage:          http://www.htpc-tech.de/voip/ast_plugin.htm

Latest version available at: http://www.htpc-tech.de/download

See the file COPYING for license information.

Description:

Provides a simple access to Asterisk voiceboxes via the OSD.

INSTALL

Use the startup parameter -d to point the plugin to the path where
voiceboxes reside (including the context name). The default location 
is /var/spool/asterisk/voicemail/default. If asterisk runs on a remote 
machine, you must mount the directory as a network share (e.g. NFS or
samba) and specify the mount point via -d. Note, that for moving and 
deleting messages you need write permissions on the directory specified.

If you do not want the voicebox directory to be mounted all the time,
an external command can be launched when the plugin is started and
terminated. The script could e.g. mount a share, or rsync the contents
or ... Specify the script using the option -m. It will be called with
two parameters. The first parameter is start or stop, depending on
the context in which the plugin is called. The second parameter is
the directory specified with -d.

HOW TO USE

In the OSD, browse voiceboxes with up and down and show messages of the currently
hightlighted voicebox using Ok. On a message press Ok to replay the message.
Red deletes the message (i.e. moves it into the trash). 
Yellow switches between different grouping modes (not grouped, grouped by caller ID,
grouped by date). Blue shows a selection of folders in that voicebox. Press Ok
on a folder to switch to it.

NOTES

- Voicemail is replayed in .wav format. Make sure that your configuration of
  asterisk actually creates .wav files (in voicemail.conf of asterisk configuration
  files)
- Currently, only one parameter -t can be given, meaning that only voiceboxes
  in one context can be used. As a workaround you can specify a directory that
  contains links to voiceboxes in various contexts.
- Currently tested with 1.3.17. Feedback about experiences with other versions
  is appreciated.

ACKNOWLEDGEMENTS

Many thanks to all people in the IRCs on #vdrportal and #asterisk and especially
to lo4dro for supporting my first steps with Asterisk!