This module allows one to play local and remote MP3 files at any sample rate.
1.1 Install dependencies
libvorbisand development libraries
liboggand development libraries
On CentOS 5.x:
On CentOS 6.x:
1.2 Enable module in build
Remove hash tag (#) in
modules.conf.in source directory:
1.3 Configure and make
mod_shout is not working, try the following:
TODO These instructions may be outdated. For example,
libshout is only included under the
Rather than relying on the overall configure script to invoke this, go to the
src/lib/libshout directory and run configure directly. If you get an error like:
1.4.2 Delete lib directories
Also, try deleting both the libs/libshout-2.2.2 and libs/lame-3.97 directory and rerunning make.
2.1 Enable module in runtime
conf/ refers to the main FreeSWITCH configuration directory. To find its exact location on your system:
2.2 Load the Module
From the CLI, run
Fast Forward / Rewind bugs
Certain things, such as fast-forward and rewind, might not work, especially if the MP3 is "badly encoded".
If these features are needed, one thing to try is to decode the MP3 to a WAV, and re-encode it back to an MP3, in order to cleanse it of errors. If this still does not work, consider converting it to a WAV, and using it in that format.
See Playing/Recording External Media for instructions on how to play an MP3 file into a conference call.
2.1.1 Local MP3 Files
Can play local MP3 files at any sample rate (8khz, 16khz, 44.5khz) in mono/stereo. Re-sampling happens on the fly.
Re-sampling can be very CPU-expensive.
2.1.2 Remote MP3 Files
2.1.3 Icecast Streams
Can play icecast streams.
TODO Add example.
2.1.4 Shoutcast streams
126.96.36.199 Using shoutcast stream for music-on-hold (MOH)
To use shoutcast for MOH, do the following:
If you just use
hold_music=shout://<url> , you will have issues after the first time you place the call on hold.
- Create a folder that contains a single file called
something.locwith the URL of the shoutcast stream
conf/autoload_configs/local_stream.conf.xmlto contain a stream that points to the folder you just created.
- Set your
hold_musicvariable to point to the local stream that you just created.
That is, from the above example, it will be
local_stream://moh/shoutin this case.
Tweak the volume parameters if the hold music is too loud via
2.1.5 Using mod_shout for TTS with online services
mod_shout for TTS is not recommend in a live environment due to lack of caching.
Can record to
- local MP3 files
- icecast and/or shoutcast streams.
2.2.1 Recording to Icecast server
To record to Icecast server from your conference or your call:
For conference, I do it from console: