LeoNerd.org.uk logo LeoNerd.org.uk LeoNerd.org.uk logo

How to Obtain

CPAN

Easiest most likely is to simply install the application using cpan, which will pull in all the dependencies.

$ cpan Circle
$ cpan Circle::FE::Gtk

Daily source

For those who want to grab all the custom perl source to build/install locally: circle-daily-src.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

Tracking development

For those who want to track development in the actual bazaar repository, and perhaps contribute.

$ 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

If you have an account on cel (and you'd know if you do :) ), you can use that instead.

First, a useful bit of .ssh/config just to make bzr URLs shorter if using sftp:

Host cel
    HostName cel.leonerd.org.uk
    User whoever
Then grab circle itself:
$ bzr branch bzr+ssh://cel/var/bzr/leo/code/circle/be circle-be
$ bzr branch bzr+ssh://cel/var/bzr/leo/code/circle/fe-gtk circle-fe-gtk
or
$ 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

How to Use

Now you can run the backend:
$ cd circle-be
$ ./circle-be -p 12345 &
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