UbuntuBots

Differences between revisions 32 and 33
Revision 32 as of 2009-04-19 23:41:05
Size: 8683
Editor: 82-37-240-159
Comment: Update and reformat
Revision 33 as of 2009-04-19 23:43:25
Size: 8663
Editor: 82-37-240-159
Comment: Links with spaces == FAIL
Deletions are marked like this. Additions are marked like this.
Line 31: Line 31:
ubotu was operated by Dennis 'Seveas' Kaarsemaker until 2008-04-28. It was the only interactive bot allowed on the Ubuntu channels. It was running supybot 0.83.1 on Ubuntu 6.06 LTS. The source code and bugtracker can be found on [[https://code.launchpad.net/~dennis/ubuntu-bots/main|Launchpad]]. ubotu was replaced by ubottu and is based on the same code. See the [[#Using%20Ubottu|Using Ubottu]] section below. ubotu was operated by Dennis 'Seveas' Kaarsemaker until 2008-04-28. It was the only interactive bot allowed on the Ubuntu channels. It was running supybot 0.83.1 on Ubuntu 6.06 LTS. The source code and bugtracker can be found on [[https://code.launchpad.net/~dennis/ubuntu-bots/main|Launchpad]]. ubotu was replaced by ubottu and is based on the same code. See the Using Ubottu section below.

Ubuntu bots

In the Ubuntu channels, there are several bots looming around for different purposes. If you run an Ubuntu channel and want one of them to join, please contact its maintainer. The bots are:

Ubuntulog

Log bot operated by the Canonical system admins (rt@ubuntu.com). Its logs may be found at http://irclogs.ubuntu.com/ .

LoCoBot

LoCoBot - Log bot for LoCoTeam channels, operated by the ubuntu-eu admin team (admin@ubuntu-eu.org). Its logs can be found at http://logs.ubuntu-eu.org/freenode/ .

MootBot

ScribesTeam/MootBot - Meeting helper bot operated by the ScribesTeam that runs in #ubuntu-meeting, designed for the chairperson of a meeting to use.

ubottu family

Based on the ubotu source and factoid database. Please send all queries about them to the #ubuntu-irc channel on Freenode.

The main bot (ubottu) is run by jussi01. primarily idles on the core Ubuntu channels.

Its source code may be found here and its SQLite factoids database may be downloaded from this location.

ubot3

Uses a slightly older ubotu source and current database. Ran by nalioth - idles on LoCoTeam channels.

ubot2 and ubot4

Uses on the ubottu source and database. Ran by jpds - idles on LoCoTeam and other channels. Database is synced from the main ubottu bot every hour.

ubotu

  • Encyclopedia/Package search/RSS/Bugtracker/Bantracker/Fun bot; usage instructions below

ubotu was operated by Dennis 'Seveas' Kaarsemaker until 2008-04-28. It was the only interactive bot allowed on the Ubuntu channels. It was running supybot 0.83.1 on Ubuntu 6.06 LTS. The source code and bugtracker can be found on Launchpad. ubotu was replaced by ubottu and is based on the same code. See the Using Ubottu section below.

uvirtbot

Does BugTracker work on channels like #ubuntu-virt. Based on ubotu. Run by Soren Hansen.

Using Ubottu

Ubottu is a (somewhat) intelligent IRC bot. The idea behind ubottu is that it remembers answers to commonly asked questions and that users of #ubuntu/#kubuntu can easily recall them when needed.

Using ubottu is simple. To ask ubottu to recall an answer, simply type in #ubuntu/#kubuntu:

!<factoid>

Replace <factoid> with the actual factoid you want to recall. If ubottu doesn't currently have the factoid, it will reply by telling you it doesn't know it.

Another way to use ubottu is to ask ubottu to tell someone else about a factoid. You can accomplish this by typing:

!tell <nick> about <factoid>
!<factoid> > <nick>

Just replace <nick> with the nickname of the person you wish to tell about <factoid>. Replace <factoid> with the factoid you wish to use.

To make ubottu reply in the channel, but prefix something to the factoid, replace > with |

!<factoid> | <nick>
ubottu: <factoid> | <nick>

You can also suggest new factoids to ubottu:

!<factoid> is <fact>

or, if an incorrect factoid has been added, make ubottu replace it with new information:

!no, <factoid> is <fact>

Replace <factoid> with the name of the new factoid and <fact> with the information for that factoid. One thing to keep in mind when creating new factoids is that they should point to official Ubuntu documentation where possible.

Due to the high volume of abuse/bogus factoids people have added to the bot, adding factoids is currently limited to registered people who have been granted access. Attempts to edit the bot by unauthorized users will be forwarded to #ubuntu-ops for review so they can be submitted to the ops for review and added if appropriate.

If you just want to search the bot or lookup factoids for yourself, you should send the commands to the bot privately:

/msg ubottu <factoid>

It will then reply to you in a private message. Please use this to keep channel traffic to a minimum.

Advanced Factoid Manipulation

<reply>

Ubottu's default response to !foo is "foo is bar". To suppress the "foo is", start the factoid with <reply>. Example:

<Seveas> !foo is <reply> bar
<Seveas> !foo
<ubottu> bar

also

!foo is foo
!foo is also bar

This will make ubottu say:

<ubottu> foo is foo
<ubottu> bar

This is mainly used for factoids that are partially LTR and partially RTL text.

<alias>

Several facts have multiple factoids pointing to them via aliases. To add an alias, you use the <alias> keyword in your fact. Example:

<Seveas> !foo is bar
<Seveas> !bar is <alias> foo
<Seveas> !bar
<ubottu> foo is bar

To display alias information, use !-<factoid>. This will either display which factoid <factoid> is an alias of, or it will list all aliases of <factoid>, whichever is appropriate.

<sed>

Ubottu can edit its factoids using sed-like expressions. If you made a typo and do not want to erase and replace the entire factoid, you can edit factoids contents:

!<factoid> =~ /<regex>/<replacement>/
!<factoid> ~= /<regex>/<replacement>/
!<factoid> is <sed> /<regex>/<replacement>/

The <sed>/=~/~= construct understands regular expressions (PCRE) for advanced editing.

Looking for Factoids

If you are looking for a specific factoid but cannot remember which one, you can search the factoid database by factoid name or fact:

!search <string>

You can use * as wildcard.

Looking for packages

You can also find out information about a package in the Ubuntu repositories:

!info <packagename>
!info <packagename> <ubuntu version>

Ubottu will tell the channel about <packagename>.

If you want to find a package of which you only know part of the name:

!find <string>
!find <string> <ubuntu version>

If no package similar to <string> ubottu will preform a file search of packages, looking for <string> in the packages file listing.

Private messages

Ubottu will also respond in private messages. You don't need to use the '!' in commands sent in private messages. He will also answer when addressed by his nickname in the channel, like this:

ubottu, tell Seveas about java
ubottu: please tell nalioth about mp3
ubottu, ati > me

Web interface

You can browse the factoids online at http://ubottu.com/factoids.cgi

Bugtracker connection

Using a very complicated regex, Ubottu looks for people who mention bug numbers/urls. It understands bugs from launchpad, bugzilla, trac, debbugs, sourceforge and issuezilla. Lots of bugtrackers are known, so it can reply to both urls and text like 'bug 123' or 'kde bug 1337'. It will reply with a short summary of the bug and its status. If you know of a bugtracker that should be added to its brain, you can poke Ubottu's administrator in #ubuntu-bots or #ubuntu-ops .

Ban tracking

In several channels, Ubottu logs all kicks, removals, bans, and mutes with a log snippet preceding the action. The ban tracker is not available to public access and only viewable to the IRC operators for Ubuntu channels.

Other functions

In #ubuntu-offtopic, the following functions may or may not be enabled, depending on abuse of the functions:

Lart plugin

@lart <nick> [for <reason>]

Time information

@now timezone

Which will display the current time and next meeting in the given timezone. Replace timezone with your timezone. A list of valid timezones can be found on http://ubottu.com/timezones.html If timezone is omitted in either command it defaults to UTC/GMT

UbuntuBots (last edited 2012-01-20 19:53:31 by alanbell1)