File	Date	Author	Commit
skins	2015-03-21	Michael Scheerer	[9a818c] Initial commit
src	2015-09-28	Michael Scheerer	[891579] skin loader fix
techdocs	2015-05-15	Michael Scheerer	[1d4737] techdocs2
AUTHORS	2015-03-21	Michael Scheerer	[9a818c] Initial commit
LICENCE	2015-03-21	Michael Scheerer	[9a818c] Initial commit
README	2015-06-15	Michael Scheerer	[dbab39] update documentation
build.xml	2015-03-21	Michael Scheerer	[9a818c] Initial commit
doppio.jar	2015-09-08	Michael Scheerer	[37f1c8] better av sync in doppio

Read Me

WHAT IT IS
----------

This is Xamp 2, the next generation of a high secure, skinnable and platform independent media player which based on the Doppio media framework. 
Parts of the GUI code of the Xamp player is loosely based on a former given up version of the open source project named jlGui 
(Java Sound API Player) on http://www.javazoom.net/jlgui/archives.html
Xamp was developed to be a real media player supporting various pluggable video and audio formats and is primarily intended 
to run as a native executable but can also run as a Java player version working with Java 1.1 VM or above.


Features
--------
Xamp supports currently decoding (playback) with following features:

-playing media from local files 
-progressive downloading media from internet sources
-rewinding with picture preview
-represents metadata stored in a database of a media
-spectrum analysing with time and frequency representation
-equalizing
-fullscreen
-selectable video scaling algorithm
-drag and drop files and folders
-M3U and PLZ playlist support


Media format support
---------------------

Ogg Sceleton     (Metadata)
Ogg Comment      (Metadata)
ID3              (Metadata)         
Ogg Vorbis       (Audio)
Wave (ULAW, ALAW)(Audio)
Snd  (ULAW, ALAW)(Audio)
AU   (ULAW, ALAW)(Audio)
Ogg Theora       (Video + Audio)
MP1, MP2, MP3    (Audio)
Mpeg1            (Video + Audio)
Mpeg2            (Video + Audio)


Usage
-----

Gui usage is much like Winamp:

- Start the player
- Drag drop media file(s) or folder(s) with files
- Alternatively use the file browser or internet browser (Eject - left and right mouse click)
- Inside the internet browser a demo file is preselected
- Press F-Key (full screen)
- Press F1-Key for retrieving media informations
- Use left arrow and/or right arrow to control rewinding and the space to resume/suspend
- Switch the focus from or to the video screen with the TAB-key
- The Border of the video screen enlightens, if the video screen got the focus
- The bubble help explains the keyboard controlled usage
 
If the graphic system is not powerful enough for scaled video display, you can use the Q(uality)-Key if the video screen got the focus.
 
If the graphic system is not powerful enough for scaled video display, you can use the Q(uality)-Key if the video screen has the focus.


Command line usage
------------------

 -j true  -  switches off jpeg picture decoding of image tags.

             You can increase the security of the player against trojan media sources to ensure, that the only one possible decoder written in C/C++ instead of Java is switched off.

 -p true  -  switches on video seeking image preview.

             You can increase the video/audio seek performance with the fast seeking option!

 -s true  -  switches on streaming mode in case of internet connection.

             You can increase the performance with the streaming option, but you cant't then seek and loop any more!

 -v true  -  switches on verbose mode.

             Prints all available informations about the played media to the standart output!

 -a small (large)  -  switches on the aspect ratio preserving with the options small or large.

 -c Mpeg2 Mpeg4 Ogg  -  activates and loads ljmf plug-ins with the names Mpeg2, Mpeg4, and Ogg.


Compiling
---------

Compiling Java:
-Install Java SDK
-Execute the Ant script to create an executable jar file
-Execute the executable jar file in the dist folder to start the player