Add a new feature for Music on Hold. If you set the "digit" option for a
[asterisk/asterisk.git] / configs / musiconhold.conf.sample
1 ;
2 ; Music on Hold -- Sample Configuration
3 ;
4
5 ; valid mode options:
6 ; files         -- read files from a directory in any Asterisk supported 
7 ;                  media format
8 ; quietmp3      -- default 
9 ; mp3           -- loud
10 ; mp3nb         -- unbuffered
11 ; quietmp3nb    -- quiet unbuffered
12 ; custom        -- run a custom application (See examples below)
13
14 ; =========
15 ; File-based (native) music on hold
16 ; =========
17 ;
18 ; This plays files directly from the specified directory, no external
19 ; processes are required. Files are played in normal sorting order
20 ; (same as a sorted directory listing), and no volume or other
21 ; sound adjustments are available. If the file is available in
22 ; the same format as the channel's codec, then it will be played
23 ; without transcoding (same as Playback would do in the dialplan).
24 ; Files can be present in as many formats as you wish, and the
25 ; 'best' format will be chosen at playback time.
26 ;
27 ; NOTE:
28 ; If you are not using "autoload" in modules.conf, then you
29 ; must ensure that the format modules for any formats you wish
30 ; to use are loaded _before_ res_musiconhold. If you do not do
31 ; this, res_musiconhold will skip the files it is not able to
32 ; understand when it loads.
33 ;
34
35 [default]
36 mode=files
37 directory=/var/lib/asterisk/moh
38 ;
39 ;[native-random]
40 ;mode=files
41 ;directory=/var/lib/asterisk/moh
42 ;random=yes     ; Play the files in a random order
43 ;digit=#        ; If this option is set for a class, then when callers are
44 ;               ; listening to music on hold, they can press this digit, and
45 ;               ; they will switch to listening to this music class.
46
47
48 ; =========
49 ; Other (non-native) playback methods
50 ; =========
51
52 ;[manual]
53 ;mode=custom
54 ; Note that with mode=custom, a directory is not required, such as when reading
55 ; from a stream.
56 ;directory=/var/lib/asterisk/mohmp3
57 ;application=/usr/bin/mpg123 -q -r 8000 -f 8192 -b 2048 --mono -s
58
59 ;[ulawstream]
60 ;mode=custom
61 ;application=/usr/bin/streamplayer 192.168.100.52 888
62 ;format=ulaw
63
64 ; mpg123 on Solaris does not always exit properly; madplay may be a better
65 ; choice
66 ;[solaris]
67 ;mode=custom
68 ;directory=/var/lib/asterisk/mohmp3
69 ;application=/site/sw/bin/madplay -Q -o raw:- --mono -R 8000 -a -12