It's better when it's simple

User Tools

Site Tools


mp3play2 Plugin

Compatible with DokuWiki

Anteater, Rincewind, Angua, Adora Belle

plugin The Mp3Play plugin let you add an flash mp3 player to your Webpage and Stream Mp3 files

Last updated on

This extension is marked as obsoleted. Therefore it is hidden in the Extension Manager and the extension listing. Furthermore, it is candidate for removal.

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with !obsolete, embed, flash, internet, mp3, music, play, radio, stream

Flash is not available anymore in browsers. Simple including single mp3s is included in DokuWiki, see the media syntax description.




Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

  • Download “MP3 Play plugin” and unzip file locally
  • Transfer to server holding Dokuwiki
    • Copy subfolder “mp3play” to: ..your..dokuwiki…/lib/plugins


The Plugin can be seen in action here FIXME

The plugin takes an xml file as input, inside as many mp3 files or streams can be defined.


“Path to the Playlist” should look something like this:





Admin setting Default value Description
Showplaylist 1 0 or 1
Showeq 1 0 or 1
Firsttrack 1 First track to play 1-x
Initvol 50 Start volume
Width 100% Width size in pixel or %
Height 320 Height in pixel or %

Playlist example

<?xml version="1.0" encoding="UTF-8"?>
  <song path="" title="Some Internetradio Mp3 Stream" />
  <song path="" title="Mountain Chill - Planets Destination for Chill" />
  <song path="" title="URL to a MP3 file on the Net" />

Change Log

  • 2011-02-17
    • Initial release
  • 2012-10-22
    • Moved repo to github

Known Bugs and Issues

Incompatibility with original mp3play plugin

By the time I wrote this plugin I didn't realized that there is already a plugin called mp3play. Therefore both plugins can't coexist, choose one.

Problems with some mp3 streams

First be sure that your Internetradio station is a mp3 stream (not ogg or something else). Second there is still some incompatibility with some browsers.

Address rewriting

Plugin cut doku.php from URL, so if you use userewrite = 1, comment $url = substr($url,0,-9); in plugin's syntax.php

And for playlist xml file, $data = $url.'/lib/exe/fetch.php/'.$data; changes to $data = $url.'/lib/exe/fetch.php?media='.$data;.

ToDo/Wish List

Let me know




Discuss here

plugin/mp3play2.txt · Last modified: 2023-04-28 19:16 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki