Asterisk Jukebox

exten => 666,1,Jukebox(default|gi)      ; Normal invokation
exten => 666,1,Jukebox(default|rn)      ; Just play random songs
exten => 666,1,Jukebox(/home/musak|rh)  ; Play one random song and hangup
exten => 666,1,Jukebox(default|R(6))    ; Recache all the TTS

** Note: 'default' points to /var/lib/asterisk/music

  -= Info about application 'Jukebox' =-

[Synopsis]
IVR app to browse a hierarchy of music files

[Description]
JUKEBOX([dir[|options]])

Description:
  This jukebox application allows a caller to browse your music
  collection.  Essentially what happens here is you point this
  application in the direction of a folder containing a bunch of
  music.  The caller will be read off the files and folders using
  text2wave, which is provided by Festival.

  At the moment, the jukebox supports all the standard Asterisk
  formats such as GSM and uLaw.  There is also MP3 support if
  you have CPU to spare and mpg123 installed via app_mp3.

Usage Instructions:
  Press '*' to go up a directory.  If you are in the root music
  folder you will be exited from the script.

  If you have a really long list of files, you can filter the list
  at any time by pressing '#' and spelling out a few letters you
  expect the files to start with.  For example, if you wanted to
  know what extension 'Requiem For A Dream' was, you'd type:
  '#737'.  Note: Phone keypads don't include Q and Z.  Q is 7 and
  Z is 9.  Star may be used as a character wildcard.  To clear
  your filter after it's been applied, just press '#'.

  Also remember that you may terminate any digit input by pressing
  the pound key.  This helps to avoid the 5 second timeout.

Options:
  R(x) -- Re-cache all text to speech files using `x' number of
          threads
  F(x) -- Changes volume scale factor; see MP3Player2() for info.
          TIP: F(4096) makes mp3 files play quieter
  h -- Hangup after playing song
  g -- Play the greeting message
  i -- Play the instructions
  r -- Start with random song
  t -- Play random song on timeout
  n -- No IVR.  Must specify with 'r'

Returns:
  The JUKEBOX() application always returns 0 unless it has trouble
  parsing the arguments you pass it.  Upon completion, a JUKESTATUS
  variable is set to one of the following values:

   - HANGUP (User hungup or error occurred)
   - TIMEOUT (User didn't enter anything at a prompt)
   - MOVEUP (User hit '*' at base directory)
   - OK (Should only return if you specify 'n' w/o 'r')

Examples:
    exten => 666,1,Jukebox(default|gi)   ; Normal invokation
    exten => 666,1,Jukebox(default|rn)   ; Just play random songs
    exten => 666,1,Jukebox(default|rh)   ; Play one song and hangup
    exten => 666,1,Jukebox(default|R(6)) ; Recache all the TTS

Advanced Configuration:

  /etc/asterisk/jukebox.conf ** OPTIONAL **

  [jukebox]
  cachedir=/var/cache/jukebox
  text2wave=text2wave                      ; and optional switches
  defaultmusicdir=/var/lib/asterisk/music