VLMa (VideoLAN Manager)
=======================

Disclaimer: This README is a developer only version.


What is the VLMa?
-----------------

The VLMa is a tool which aims at providing a web interface to manage 
several servers running VLC at the same time.


How to compile
--------------

Requirements:
 - Java (version >= 1.5)
 - Maven2

The VLMa uses Maven as a build system. If you are not familiar with 
this tool, take a look at http://maven.apache.org.

To compile the project, run from the root folder:
  % mvn install


Try it !
--------

To try the VLMa, run from the daemon folder:
  % mvn compile exec:java

and then run from the web folder:
  % mvn jetty:run

You sould now be able to access the web interface at 
http://localhost:8080.

Have fun!


Eclipse integration
-------------------

If you wish to develop the VLMa within Eclipse, install a Maven2 Eclipe 
integration plugin like this one:
http://m2eclipse.codehaus.org

You can now import the project into Eclipse using the File > Import wizard.


Eclipse compilation
-------------------

Always compile the core first :
In your workspace, click right on vlma-core directory, then on "Run As" and
first on "Maven Clean" and secondly on "Maven Install". This should compile
the core and install it into your local Maven repository.

Compile and launch the deamon :
Do the same as for the core for the vlma-deamon directory. "Maven Install"
function will this time also run the deamon.

Compile and launch the web aplication :
Do again the same with the "vlma-web" directory.
To launch the web application, you need to configure an external tools.
To do that click on the menu "Run" then on "External Tools" and again on
"External Tools". A window should appear.
Create a new launch configuration in the "Maven Build" node of the tree.
Name it "vlma-web". For the "Base directory", browse your file system to
vlma-web directory. Type "jetty:run" in the "Goals" textbox.
Finaly click on "Run" button.

That's it : you have got a vlma devel version which runs !
