DIEGO Streaming Server  


DIEGO is an open source MP3 Streaming Music Server. It is conceptually based on the Edna MP3 Server written by Greg Stein. Edna is written in PHP and can be found at http://edna.sourceforge.net/. DIEGO is a standalone HTTP socket server written in Java. It is available under the GNU General Public License (GPL).

DIEGO listens on port 8008 for HTTP browser requests and dynamically displays a list of available songs. Diego lists only mp3 files and m3u playlists in the specified directory and sub-directories. All other file type are ignored and are neither displayed or served. DIEGO conveniently displays the file size next to the song name. All files newer than a certain number of days are displayed with a "new" icon.

When you click on a song title, DIEGO returns a .m3u playlist containing the song information, rather than the actual mp3 file. Your browser will then make a call to your mp3 player (WinAmp/MediaPlayer for example) and pass this information. Your mp3 player will then request that DIEGO stream the song to it. The song will begin playing after some of it has been buffered.


By serving playlists, DIEGO can play all songs in a directory (randomly or in alphabetical order). It can also play all songs including those in sub-directories recursively (also alphabetically or randomly). Lastly, DIEGO allows you to create your own custom playlists by selecting only certain songs.

DIEGO works on intranets as well as accross the internet, even if you are behind a firewall or proxy server.

DIEGO also allows you to view your access log for each directory, or the entire access log by going to the root directory. In the future, other access statistics will be added.



Downloading DIEGO

Please go to the DIEGO project page at http://sourceforge.net/projects/diego to download the latest zip archive containing the DIEGO jar, icons, and source code. When the download is complete, decompress the archive contents and move the diego folder to where it is most convenient for you. Before you run DIEGO, you should edit the configuration file called Diego.properties.

Running DIEGO

In order to run DIEGO, you need to have the Java Runtime Environment (JRE) 1.4.0 or better. If you already have Java installed, all you need to do is edit the configuration file Diego.properties to suit your needs. Once this is done, DIEGO can be started from the supplied unix shell or windows batch script. Now you are ready to connect to DIEGO with your browser and enjoy your favorite songs.

Getting the Source Code

If you have CVS installed, you can get the latest DIEGO source code by typing the following in your command line/unix shell:

c:\> cvs -d :pserver:anonymous@cvs.diego.sourceforge.net:/cvsroot/diego login
password: (Press Enter)
c:\> cvs -z6 -d :pserver:anonymous@cvs.diego.sourceforge.net:/cvsroot/diego checkout diego

If you do not have CVS installed you can view the DIEGO source files using ViewCVS at http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/diego/diego.

Send your comments or suggestions to gulembo@users.sourceforge.net,

Please Enjoy the DIEGO MP3 Server!