Click here to Skip to main content
Click here to Skip to main content
Go to top

SmartIrc4net - the C# IRC library

, 19 Sep 2004
Rate this:
Please Sign up or sign in to vote.
IRC library for .NET.

Introduction

I wrote SmartIrc4net for having a high-level IRC API for .NET/C#. I started long time ago with IRC programming for PHP, I wrote Net_SmartIRC. Net_SmartIRC is a PEAR class. Later, I was disappointed that the OO features of PHP are so limited. I was starting to port the project to C++, after a few weeks I stopped, so many things are missing and have to be written (even simple things like string manipulation). Then I found C#. And I ported SmartIRC in about 1-2 weeks! After that the API got better and better, it's just great what it is now... so here we are SmartIrc4net.

Object Design

This library has a 3 layered API, allows developers to pick the layer/features he needs. You could use any layer for writing IRC applications, the question is how much IRC abstraction and features you need. You have the choice!

Layer 1: IrcConnection

This layer is a low-level API and manages the messagebuffer (for reading and writing). Also, the ping/pong and connection handling is done.

Layer 2: IrcCommands (extends IrcConnection)

This layer is a middle-level API. It contains all IRC RFC commands plus some useful and easy to use IRC methods (like Op, Deop, Ban, Unban etc.).

Layer 3: IrcClient (extends IrcCommands)

This layer is a high-level API with all features you could need for IRC programming, like channel syncing (keeping track of channels in objects with modes/topic/users), user syncing (for nicks, indents, hosts, realnames, servers, and hopcounts). This layer is fully event driven, all received data is parsed into different events with special arguments for each event (this makes it very easy to use the received IRC data without checking each time the RFC!)

How to use SmartIrc4net

Here is an example of how to use the library using the high-level API:

using System;
using System.Collections;
using Meebey.SmartIrc4net;
using Meebey.SmartIrc4net.Delegates;

public class Test
{
    public static IrcClient irc = new IrcClient();

    public static void OnQueryMessage(Data ircdata)
    {
        switch (ircdata.MessageEx[0]) {
            case "join":
                irc.Join(ircdata.MessageEx[1]);
            break;
            case "part":
                irc.Part(ircdata.MessageEx[1]);
            break;
            case "say":
                irc.Message(SendType.Message, MessageEx[1], MessageEx[2]);
            break;
        }
    }

    public static void Main(string[] args)
    {
        irc.SendDelay = 200;
        irc.AutoRetry = true;
        irc.ChannelSyncing = true;
        irc.OnQueryMessage += new MessageEventHandler(OnQueryMessage);

        string[] serverlist;
        serverlist = new string[] {"irc.ircnet.net"};

        int    port   = 6667;
        if(irc.Connect(serverlist, port) == true) {
            irc.Login("SmartIRC", "Stupid Bot");
            irc.Join("#smartirc");
            irc.Message(SendType.Message, "#smartirc", "test message");
            irc.Message(SendType.Action, "#smartirc", " thinks this is cool");
            irc.Message(SendType.Notice, "#smartirc", "SmartIrc4net rocks!");
            }
            irc.Listen();
            irc.Disconnect();
        } else {
            System.Console.WriteLine("couldn't connect!");
        }
    }
}

Connect to your favorite IRC server, set the IRC server in the source. Join the #smartirc channel. Compile the source, spawn the bot. The bot should come and say three messages, after that send him a private message: "/msg smartirc say #smartirc hello!".

Official Project Page

SmartIrc4net is an own project which you can find here. There you get the current versions, can report bugs or post help requests on the forum. Comments, suggestions and criticism are welcome!

Have fun

There you go, have fun with bot coding! Wink | ;)

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

meebey

Germany Germany
No Biography provided

Comments and Discussions

 
QuestionHow to stop listening to the server? PinmemberMember 1021809125-Aug-13 19:55 
QuestionMutliple-Users for AJAX Chat PinmemberMember 807251618-May-12 23:42 
GeneralMy vote of 1 PinmemberxComaWhitex6-Jan-11 22:28 
QuestionC# Application instead of console? PinmemberLevisaxos9-Nov-09 3:38 
GeneralStill not working... Pinmembersupra5619-Jul-07 5:08 
GeneralVoice Conference-HELP PLZ!! Pinmembermfc_surfer12-Jun-07 3:21 
GeneralRe: Voice Conference-HELP PLZ!! Pinmembermeebey12-Jun-07 3:30 
IRC is text only, no voice no video. See: http://en.wikipedia.org/wiki/Internet_Relay_Chat

GeneralRe: Voice Conference-HELP PLZ!! Pinmembermfc_surfer12-Jun-07 23:04 
GeneralRe: Voice Conference-HELP PLZ!! Pinmemberfarzade14-Oct-07 19:39 
GeneralRe: Voice Conference-HELP PLZ!! PinmemberCompMan4423-Aug-08 21:12 
GeneralIRC Server Pinmembermfc_surfer10-Jun-07 22:02 
GeneralRe: IRC Server Pinmemberfarzade14-Oct-07 19:55 
Questionhow do I compile this? PinmemberV32546-Apr-07 3:03 
AnswerRe: how do I compile this? Pinmembermeebey6-Apr-07 4:45 
AnswerRe: how do I compile this? PinmemberYeorwned11-May-09 8:18 
Questionother english language can support ? Pinmemberabcomp0120-Nov-06 20:53 
Questioncan through NAT? Pinmemberiamcoder27-Apr-06 23:18 
AnswerRe: can through NAT? Pinmembermeebey28-Apr-06 0:25 
GeneralRe: can through NAT? Pinmemberiamcoder28-Apr-06 21:07 
GeneralRe: can through NAT? Pinmembermeebey29-Apr-06 1:39 
GeneralRe: can through NAT? Pinmemberiamcoder29-Apr-06 17:01 
GeneralExample has few errors. Pinmemberchmod222224-Jan-06 23:07 
GeneralUpdated Article Pinmembermeebey16-Jan-05 7:27 
GeneralHesh wants DCC! :P PinsussFocusedWolf28-Sep-04 2:54 
Generalbugs in the example Pinmembermeebey26-Sep-04 10:21 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140926.1 | Last Updated 19 Sep 2004
Article Copyright 2004 by meebey
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid