Read Me

=========================================
        README OF JPODCAST SERVER
=========================================

 Home Page Project: 
	
       http://jpodcast.comvalid.com/
 
 
 Home Page Sourceforge.net Project: 
	
       http://sourceforge.net/projects/j-podcast
 
 
 You can find more coumentation on the project wiki:
	
       http://wiki.jpodcast.comvalid.com/

 For any question (Bug Report,Info) you can send email to:
	jpodcast@comvalid.com

	
======================
    JPodcast Server
======================

JPodcast is much different from most of the Podcast tools used in 
the middle of 2006, because it is a real native Podacast Server, 
and not a blog server extended to support enclosures. So sorry but you 
cannot make a blog server out of JPodcast, but if you need to do podcasting,
it's the real tool for you since does not embed all the complications linked 
to set up a blog server.

JPodcast has been designed so that it can be used in different ways, 
some of them still in development, and some of them we still don't see 
and we hope you will tell us. Here is our list:

        * Simple file podcaster: you install JPodcast and put your files 
		inside the "channel/default" folder (or link that folder to 
		your mp3 dir). At this point you manage your Podcast channel adding
		or removing files from such directory, of course take care 
		to have them properly tagged with Id3 mp3 tags.
    
	* Delivery engine for a CMS: if you already operate a Content Management
		System or a Portal, you can just use JPodcast as the delivery engine 
		for the file of a specific area of your Portal, besides the use of the 
		file tags (ex: mp3's id3), you can provide specific criteria to JPodast 
		with the use of .xml files associated to the channel and items in the 
		delivery directory.
    
	* Managed podcaster: with the help of the web of the web 2.0 administration
    	        and managing interface in development, we want to provide a method to 
		operate the Podcast server and the different Channels from remote, 
		without the need to act directly on the file system

JPodcast is a podcast server platform, written in 100% Java.
It is designed to be light weight, high performance, embeddable,
extensible and flexible, thus making it an ideal platform 
for run on different platforms:

    * Windows
    * Linux
    * MacOs

using different servlet containers:

    * Tomcat
    * Jetty

Classes of JPodcast server have been compiled to default on a unix 
system machine with these characteristics:
   + Operating system:  "Linux Debian i686 kernel-2.6.16.9"  
   + Java: "J2EE SDK 1.4"
       - it has been installed from a sun package "j2sdk-1_4_2_11-linux-i586.bin"

If you want anytime regenerate the  bytecode on your machine, because you have a 
different version of java ( for example: 1.5 or 1.6beta ), see the part called 
"BUILDING FROM SOURCE WITH 'ANT'" in INSTALL.txt file.

====================
  Package contents
====================

 + channels/default
               - The default directory for the file to podcast.
 + src	       - The source code for JPodcast
 + WEB-INF
     /classes  - Files .class generated with ANT command.
     /lib      - The jars used by JPodcast code.

===============
  Support FAQ
===============

 + When posting a support question, please provide as much information as
    possible, which should include:
      - The version of JPodcast.
      - The version of java.
      - Your Operating system.
      - Overview of your configuration.
      - What URL was tried.
      - What browser and what it rendered.
      - Details of the problem, including stack traces and/or log files.
      - Details of what you have tried to make it work.
	 
	For any question (Bug Report,Info) you can send email to:
		jpodcast@comvalid.com
		
================
  Distribution
================
  JPodcast distributions and informations are available from:
   
   http://sourceforge.net/projects/j-podcast
   http://jpodcast.comvalid.com/
   http://wiki.jpodcast.comvalid.com/

=====================
  How to Contribute
=====================
Comments, contributions, feedback, bugs, testing, etc. please....
The mailing lists  & wiki are the best places to start:
  
  http://sourceforge.net/projects/j-podcast
  http://wiki.jpodcast.comvalid.com/

Or send directly a mail to jpodcast@comvalid.com