How to Obtain

JustDoIt

For those who want to Just Do It and grab a ready-to-run bundle of perl files: circle-daily-JDI.tar.bz2

This contains both the backend and the GTK frontend source, in separate directories. Each contains a install-cpan script which will install the required dependencies from CPAN (though you may wish to check if your OS distribution already provides them first). Once these dependencies are installed, either by this script or though your OS's packages, you can then build the actual program

perl Build.PL
./Build

Daily source

For those who want to grab all the custom perl source to build/install locally: circle-daily-src.tar.bz2

See the notes above about the install-cpan script.

Tracking development

For those who want to track development using 'bzr', and perhaps contribute: Useful bit of .ssh/config just to make bzr URLs shorter if using sftp:

Host cel
    HostName cel.leonerd.org.uk
    User whoever

For the backend, you'll need a perl module that isn't on CPAN:

• Tangence

Grab it in the following way

$ bzr branch sftp://cel/var/bzr/leo/perl/Tangence
 or
$ bzr branch http://bazaar.leonerd.org.uk/perl/Tangence

$ cd Tangence
$ perl Build.PL && ./Build && ./Build test
$ ./Build install install_base=~

Then grab circle itself:

$ bzr branch sftp://cel/var/bzr/leo/code/circle/be circle-be
$ bzr branch sftp://cel/var/bzr/leo/code/circle/fe-gtk circle-fe-gtk
 or
$ bzr branch http://bazaar.leonerd.org.uk/code/circle/be circle-be
$ bzr branch http://bazaar.leonerd.org.uk/code/circle/fe-gtk circle-fe-gtk

How to Use

Now you can run the backend:

$ cd circle-be
$ ./circle-be -p 12345 &

The frontend only needs Tangence; so if you're wanting to run FE on another machine, it's only this you need to fetch and build there. Now you can run the frontend:

$ cd circle-fe-gtk
$ ./circle-fe-gtk tcp://server:12345

Then in main tab:

/networks add MyNet

Then in new MyNet tab:

/nick Foobar
/connect irc.mynet.org
/join #channel