OpenCHAT 0.43 README
OpenCHAT is free 100% HTTP/HTML chatting server entirely written in Java. On the server side,
it does not need any HTTP server (like Apache) or SQL database run with. OpenCHAT has it's own
HTTP server which handles all TCP/IP Socket HTTP connections with the client browsers as
well as all user to user communications, using Java threads. On the client side, a frame anabled
HTTP web browser is all the user needs to communicate (Internet Explorer, Netscape, etc.).
No applets or special software is needed on the client side. OpenCHAT is NOT a IRC like chat
engine, but a much easyer interface to the (unexperienced) end user deal with.
OpenCHAT intends to be a full featured chatting solution targeting home and corporate users who
plan to have their own chat domains and rooms. OpenCHAT can be used on multi-domain web servers
offereing a completely independent user space for each domain, like the Apache <VirtualHost>
directive does. By now, OpenCHAT supports only pre opened rooms, but will in the future support
other room types.
o Multiple languages supported on a per domain basis
0 Fully comtomizable templating engine
o Unlimited multiple VirtualDomains (hosts) with separate user spaces
o Unlimited rooms separated by VirtualDomains.
o Full HTML template system, allowing different design for each VirtualDomain and room
o Full HTML interface
o Integrated HTTP web server
o No applets, web server or database install needed
OpenCHAT freely avaiable from http://sourceforge.net/projects/openchat/
Please download allways the latest version.
Please refer to the INSTALL file included in the distribution.
README This file.
INSTALL OpenCHAT installation instructions.
OpenCHAT.jar Stores all classes in. Can be decompressed if you prefer to work with individual classes.
META-INF/MANIFEST.MF The Java Manifest file.
OpenCHAT.conf The main configuration file must be placed at /etc/OpenCHAT.conf or \etc\OpenCHAT.conf for
the Win32 folks. OpenCHAT also looks for this file at the current working directory.
OpenCHAT.Domains.conf You can configure several different Domains to work separatly with this file.
It must be placed at <CHAT_ROOT_DIR>/OpenCHAT.Domains.conf. OpenCHAT also looks for this
file at the current working directory.
OpenCHAT.tpls This file is used to load HTML templates used for all domains. The begining of thif file
contains all docs.
<DOMAIN_NAME>.tpls Like OpenCHAT.tpls, this file is used to load HTML templates, but this one only for the
specifyed domain. The templates contained in this file overrides the OpenCHAT.tpls ones.
A default example file is included in this package, named SISTEMICA.INFO.tpls
OpenCHAT.rooms This file is used to pre open rooms, in all domains.
<DOMAIN_NAME>.rooms Like the OpenCHAT.rooms, this file pre opens rooms, but this one only in the specifyed
domain. A default SISTEMICA.INFO.rooms file is included in this package.
OpenCHAT.lang OpenCHAT language templates and user defined language templates.
<DOMAIN>.lang The same as OpenCHAT.lang, but aplies only for the specifyed domain. It overrides
There are examples of all these files in the tar ball, with comments.
Read the ".conf", "*.tpls", ".rooms" and ".lang" files. They are very well commented.
There may be some. Please report them to us and we'll release new versions as fast as possible.
Prevent DoS attacks.
Support the POST HTTP method.
The OpenCHAT web site :-)
Fell free to contact the author on <email@example.com>.
The OpenCHAT Project accepts domations using PayPal. Please visit the OpenCHAT Project page at
SourceForge.net for further explanation.
All donations to the OpenCHAT Project are 100% sent to Brazilian Social Charity NGOs.
Please read the DONATIONS file.
COMMERCIAL SUPPORT AND DEVELOPMENT
Commercial support and custom development is provided by Sistemica.info Software worldwide.
Diego de Lima <firstname.lastname@example.org>
Av. Carlos Gomes, 75 5. andar
90480-003 - Porto Alegre - RS - Brazil