User Manual

System Requirements

Java 1.6 must be installed on the system to run web server with OpenMp3Player. It should run on any operating system (Linux, OS X, Windows).


Installation is the trickiest part here, since the OpenMp3Player runs as a web application on Apache Tomcat server (JBOSS was not tested yet). Just follow the steps:

1. download Apache Tomcat (version 6 or above) and unzip it to custom directory

2. start Tomcat server from command line: ~/tomcat/bin/ (on Windows use startup.bat)

3. unzip OpenMp3Player to custom directory

4. copy the OpenMp3Player.war into ~/tomcat/webapps directory

5. open web browser and go to: http://localhost:8080/OpenMp3Player

Creating playlists

Open playlist editor and enter name of playlist (eg. My Salsa Hits) and enter path to a directory on the system which contains your favorite salsa mp3 files and hit 'Add' button.
Go back to Player and you should see a playlist in dropdown menu. Select playlist My Salsa Hits and a list of songs will be displayed.


Queue is a special type of playlist which holds temporary mp3 files that you would like to listen later. Any song from any playlist can be added into queue. Inside PlaylistEditor you can save queue as playlist (it will be loaded next time when OpenMp3Player is started) or you can empty the queue and fill it with new selection of songs.
OpenMp3Player always starts with empty queue.

Shutting down

To uninstall OpenMp3Player delete the OpenMp3Player.war from ~/tomcat/webapps directory. Tomcat will automatically undeploy the application. Next you can stop Apache Tomcat server from command line: ~/tomcat/bin/ (on Windows use shutdown.bat).

Command line interface

OpenMp3Player can be managed remotly through the telnet connection. In terminal window connect to OpenMp3Player: telnet hostname 4444

You should see prompt player>. Use 'help' to see list of available commands.