SVN Installation of WillowChat

This document provides information about installing Willow Chat on any system.

Dependencies

Python 2.5

For any system you can visit http://www.python.org and download the appropriate installer. Many systems come with Python. You can check by running python in a terminal and seeing if it starts. Make sure the version number is 2.5.x. On Windows it's helpful to add the Python install directory and the Python scripts directory to the path.

setuptools

Many systems already have setuptools. For Debian/Ubuntu, run apt-get install python-setuptools. You can use the ez_setup.py script on any system. Download the script and run python ez_setup.py setuptools (you will need sudo on Ubuntu).

Twisted

You need to install Twisted to use willowchat. There are installers for most systems that the Twisted Installation Page.

Orbited 0.7 SVN

Run: easy_install orbited. If you already have an older version of orbited installed, you need to add a -U flag to signify that you wish to upgrade: easy_install -U orbited.

If you need more information, see the Orbited docs on installation and Windows installation.

Willowchat svn

svn co http://www.willowchat.org/svn/willowchat/trunk/daemon willowchat
cd willowchat
python setup.py develop

Running/Developing

At this point you will have Willow Chat installed to run from the SVN checkout directory. You can modify any of the Willow Chat static files and the changes will be found by a running daemon. If you modify the configuration file, you need to restart the daemon.

To run the daemon, type willowchat which will look for the default config file wc.cfg in that directory. You can use your own configuration file with willowchat --config /path/to/custom.cfg

The default willowchat port is 8007 (this can be changed in the config). It will also run the built-in IRC server on port 9999.

To test the install, visit http://localhost:8007/static/

You can connect to localhost:9999 with an IRC client.