minbif(8) [debian man page]

MINBIF(8)						      System Manager's Manual							 MINBIF(8)

NAME

       minbif - The IRC instant messaging gateway

SYNOPSIS

       minbif [-hv] [--pidfile pidfile] CONFIG_FILE

DESCRIPTION

       Minbif is an IRC gateway to IM networks which provides the following features:

       * Minbif uses a library which abstracts all IM calls, and has several plugins to support more than 15 IM protocols (IRC included!);
       * Two modes: inetd and daemon fork;
       * Only IRC commands are used to control Minbif;
       * IM Certificates check;
       * Buddies are IRC users;
       * Each account is associated to a status channel, where all connected buddies are;
       * Add and remove buddies from list with /INVITE and /KICK commands;
       * Blocked users are bans on the account's status channel;
       * Display when a buddy is typing a message;
       * Can chat with someone who is not in your buddy list;
       * You can see buddies' icons (with libcaca) or download them;
       * DCC SEND an image to set your icon on IM networks;
       * Display extended information about buddies with /WII command;
       * Status management;
       * Can send and receive files, which are sent or received to/from your IRC client with DCC SEND;
       * Conversation channels are supported;
       * Auto-rejoin conversation channels at connection;
       * Display list of channels on an IM account with /LIST;
       * irssi scripts to increase your user experience of minbif;
       * CACAcam (webcam in ascii art);
       * CoinCoin plugin for libpurple;
       * PAM support;
       * TLS support with certificate auth.

OPTIONS

       --pidfile pidfile
	      path to pidfile where the minbif's PID is written.

       --version
	      display version of minbif.

       --help show help.

       config_file
	      Configuration file location.

CONFIGURATION

       Edit the minbif.conf file and change value when needed.

       With the inetd mode, use this command to add minbif:
       # update-inetd --add '56667 stream tcp nowait minbif /usr/sbin/tcpd /usr/bin/minbif /etc/minbif/minbif.conf'

       With the daemon fork mode, run minbif with:
       # minbif /etc/minbif/minbif.conf

HOW TO USE

       Connect your IRC client (for examble irssi) on minbif with this command:
       /server localhost 56667 password

       The nickname set on your IRC client is your username on minbif. First time you connect to minbif with this nickname, the account is created
       and the password parameter is set.

       Next, use the /map help command to know how to add a network.

       See also: http://minbif.im/Quick_start

COPYRIGHT

       Copyright(C) 2009-2011 Romain Bignon

       For full COPYRIGHT see COPYING file with minbif package.

FILES

	"minbif.conf"

								 04 December 2011							 MINBIF(8)

Check Out this Related Man Page

POE::Component::IRC::Cookbook::BasicBot(3pm)		User Contributed Perl Documentation	      POE::Component::IRC::Cookbook::BasicBot(3pm)

NAME

       POE::Component::IRC::Cookbook::BasicBot - A basic IRC bot

SYNOPSIS

       This a very basic bot that connects to IRC, joins a few channels, and announces its arrival.

DESCRIPTION

       We start off quite simply:

	#!/usr/bin/env perl

	use strict;
	use warnings;

       Then we "use" the stuff we're going to...well, use. "::State" is a subclass which keeps track of state information related to channels and
       nicknames. It is needed by the "AutoJoin" plugin which takes care of keeping us on our channels.

	use POE;
	use POE::Component::IRC::State;
	use POE::Component::IRC::Plugin::AutoJoin;

       Next up is our POE session. We create it and list our event handlers. We then start the POE kernel.

	POE::Session->create(
	    package_states => [
		main => [ qw(_start irc_join) ]
	    ]
	);

	$poe_kernel->run();

       Now all we have to do is write the handlers for "_start" and "irc_join".  In "_start", we create our IRC component, add an "AutoJoin"
       plugin, register for the "irc_join" event, and connect to the IRC server.

	sub _start {
	    my $irc = POE::Component::IRC::State->spawn(
		Nick   => 'basic_bot',
		Server => 'irc.freenode.net',
	    );

	    $irc->plugin_add('AutoJoin', POE::Component::IRC::Plugin::AutoJoin->new(
	       Channels => [ '#test_channel1', '#test_channel2' ]
	    ));

	    $irc->yield(register => 'join');
	    $irc->yield('connect');
	}

       Now comes our "irc_join" event handler. We send a message to the channel once we've joined it.

	sub irc_join {
	    my $nick = (split /!/, $_[ARG0])[0];
	    my $channel = $_[ARG1];
	    my $irc = $_[SENDER]->get_heap();

	    # only send the message if we were the one joining
	    if ($nick eq $irc->nick_name()) {
		$irc->yield(privmsg => $channel, 'Hi everybody!');
	    }
	}

       That's it!

AUTHOR

       Hinrik Oern Sigur`sson, hinrik.sig@gmail.com

perl v5.14.2							    2011-12-07			      POE::Component::IRC::Cookbook::BasicBot(3pm)

Linux and UNIX Man Pages

minbif(8) [debian man page]

Check Out this Related Man Page