Skip to content



Play an MP3 file or M3U playlist file or stream.


Executes mpg123 to play the given location, which typically would be a mp3 filename or m3u playlist filename or a URL. Please read to see what the M3U playlist file format is like.

Note that mpg123 does not support HTTPS, so use HTTP for web streams.

User can exit by pressing any key on the dialpad, or by hanging up.

Example: Play an MP3 playlist
exten => 1234,1,MP3Player(/var/lib/asterisk/playlist.m3u)
This application does not automatically answer and should be preceeded by an application such as Answer() or Progress().


  • Location - Location of the file to be played. (argument passed to mpg123)

Generated Version

This documentation was generated from Asterisk branch 21 using version GIT