Event-based stateful IRC client framework for Go.
Branch: master
Clone or download
Pull request Compare This branch is 2 commits ahead, 402 commits behind fluffle:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


GoIRC Client Framework

Acquiring and Building

Pretty simple, really:

git clone git://github.com/fluffle/goirc.git
make -C irc install

You can build the test client also with:


This will connect to freenode and join #go-nuts by default, so be careful ;-)

Using the framework


import "irc"
func main() {
    c := irc.New("nick", "ident", "real name")
    // add handlers to do things here!
    if err := c.Connect("irc.freenode.net", ""); err != nil {
	    fmt.Printf("Connection error: %s\n", err.String())
    for {
        if closed(c.Err) {
        if err := <-c.Err; err != nil {
            fmt.Printf("goirc error: %s", err.String())

The test client provides a good (if basic) example of how to use the framework. Reading irc/handlers.go gives a more in-depth look at how handlers can be written. Commands to be sent to the server (e.g. PRIVMSG) are methods of the main *irc.Conn object, and can be found in irc/commands.go (not all of the possible IRC commands are implemented yet). Events are produced directly from the messages from the IRC server, so you have to handle e.g. "332" for RPL_TOPIC to get the topic for a channel.

The vast majority of handlers implemented within the framework deal with state tracking of all nicks in any channels that the client is also present in. It's likely that this state tracking will become optional in the near future.


Sorry the documentation is crap. Use the source, Luke.

Feedback on design decisions is welcome. I am indebted to Matt Gruen for his work on go-bot which inspired the re-organisation and channel-based communication structure of *Conn.send() and *Conn.recv(). I'm sure things could be more asynchronous, still.

This code is (c) 2009 Alex Bramley, and released under the same licence terms as Go itself.