My favorites | Sign in
Project Logo
                
Search
for
Updated Dec 23, 2006 by quen...@gmail.com
Labels: Phase-Deploy, Featured
Readme  
Readme file for SeeBorg.

SeeBorg readme file


SeeBorg is a random phrase bot that will sit on IRC channel, learning the talk, and periodically replying with something that is generated from the talk learned before. It usually doesn't make much sense, but sometimes it's funny, and sometimes very hilarious.

There are some configuration options that will make you able to tweak some of the bot's behaviour. Also if you set yourself as an owner, you will get access to IRC trigger commands (those that begin with '!').

It can learn in any language, not just english, but for better character processing (like case conversion), you will need to set appropriately your system locale.

To compile, read the Makefiles and make any changes required (you may probably want to change CFCPU to better value), then type `make' and fix the errors which will be displayed, if any. SeeBorg is in development and probably won't work as you expect.

After running "make", you'll end up with two executables - "seeborg-irc" and "seeborg-linein", these are IRC client or linein interactive mode respectively. The linein is useful for offline chat with the bot and to test the modifications done to the dictionary.

Without any parameters, seeborg-irc reads configuration from "seeborg-irc.cfg" file located in current working directory. If it doesn't exist, it will create one and terminate, suggesting you to inspect the config file, that would be a good idea.

If you find this program entertaining, you might want to help me develop it. The TODO file contains a list of yet-to-be-done things/ideas.

Configuration settings


server - server to connect to (default: none)
serverport - port of the server to connect to (default: 6667)
nickname - nickname (default: SeeBorg)
username - username (default: SeeBorg)
realname - realname (default: I am SeeBorg v0.52 beta)
quitmessage - quit message (default: ByeBye...)
learning - Enable/disable learning capability. (default: enabled)
stealth - Enable/disable masking as a regular mIRC user. (default: enabled)
replyrate - Bot's reply rate, in percent (default: 1)
replynick - Bot's reply rate to his nickname, in percent (default: 33)
replymagic - Bot's reply rate to magic words set in 'magicwords', in percent (default: 33)
autosaveperiod - Autosave period, in seconds (default: 600)
channels - Space separated channel list to autojoin on connect (default: #test #seeborg)
magicwords - Space separated magic word list to reply to according to replymagic value, useful if bot has alternative nicknames, like russian. (no default)
owners - Space separated bot owners' nickname list, the owner's hostname will be locked after each bot restart. (no default)

Portability


It compiles succesfully with GCC v2.95.3, GCC v3.2, GCC v3.2.2 and MSVC v6.0. Tested succesfully on Linux 2.4.x, FreeBSD 4.6.2, mingw32 and Win32.

I see no reason why it shouldn't compile and run on any other platform that is supported by botnet library and supports standard C++.

If compiling under mingw32 and cygwin, you would want to uncomment LDFLAGS line (one with -lwsock32) in the Makefiles.

Credits and copyright


This software comes with ABSOLUTELY NO WARRANTY and is subject to the terms of the GNU General Public License (GPL), see the accompanying 'COPYING' file.

This software uses Markov Chain algorithm for building reply messages. It is a C++ clone of PyBorg, originally written by Tom Morton.

This software uses BotNet library written by Christophe CALMEJANE to connect and interact with IRC servers. The library is included in the tarball.

If you plan using BotNet, please download the original package, since this one is a cut-down version and tailored for SeeBorg, your mileage may vary.

SeeBorg is (C) 2003-2006 Eugene 'HMage' Bujak.

BotNet is (C) Christophe CALMEJANE 'Ze KiLleR / SkyTech'


Comment by Sataaa, Jul 25, 2008

worth mentioning that !help, when being the owner, gets you all the info from the bot.

Comment by verbinurnoun, Aug 08, 2008

BEST PROGRAM EVER.

Comment by antdude, Sep 15, 2008

Cool bot, would love to see updates. :)

Comment by Supermetalfreak, Dec 13, 2008

Cool bot. Would be awesome if it would copy /me

Comment by MoldyAngle, Jun 26, 2009

You DO realize that there are people who will be new at this and NOT know how to 'make', right?


Sign in to add a comment
Hosted by Google Code