UbuntuBots

Differences between revisions 27 and 28
Revision 27 as of 2008-12-20 14:38:06
Size: 8763
Editor: 82-37-240-159
Comment: Fix formatting
Revision 28 as of 2009-01-19 23:54:17
Size: 8851
Editor: 82-37-240-159
Comment: more ubotu -> ubottu and move to ubottu.com
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
Its source code may be found [[https://code.launchpad.net/~tsimpson/ubuntu-bots/tweak|here]] and its SQLite database may be downloaded from [[http://jussi01.com/web/ubuntu.db|this location]]. Its source code may be found [[https://code.launchpad.net/~tsimpson/ubuntu-bots/tweak|here]] and its SQLite database may be downloaded from [[http://ubottu.com/ubuntu.db|this location]].
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 [[http://launchpad.net/products/ubuntu-bots/|Launchpad]]. 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.
Line 36: Line 36:
== Using Ubotu ==

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

Using ubotu is simple. To ask ubotu to recall an answer, simply type in #ubuntu/#kubuntu:
== 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:
Line 46: Line 46:
Replace <factoid> with the actual factoid you want to recall. If ubotu doesn't currently have the factoid, it will reply by telling you it doesn't know it.

Another way to use ubotu is to ask ubotu to tell someone else about a factoid. You can accomplish this by typing:
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:
Line 57: Line 57:
To make ubotu reply in the channel, but prefix something to the factoid, replace {{{>}}} with {{{|}}} To make ubottu reply in the channel, but prefix something to the factoid, replace {{{>}}} with {{{|}}}
Line 64: Line 64:
You can also suggest new factoids to ubotu: You can also suggest new factoids to ubottu:
Line 70: Line 70:
or, if an incorrect factoid has been added, make ubotu replace it with new information: or, if an incorrect factoid has been added, make ubottu replace it with new information:
Line 90: Line 90:
Ubotus default response to !foo is "foo is bar". To suppress the "foo is", start the factoid with <reply>. Example: Ubottu's default response to !foo is "foo is bar". To suppress the "foo is", start the factoid with <reply>. Example:
Line 104: Line 104:
This will make ubotu say: This will make ubottu say:
Line 128: Line 128:
Ubotu 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: 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:
Line 170: Line 170:
Ubotu 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 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:
Line 180: Line 180:
You can browse the factoids online at http://jussi01.com/web/factoids.cgi

 * [[http://jussi01.com/web/factoids.cgi?db=ubuntu&search=&order=popularity%20DESC&page=0|Most popular first]]
 * [[http://jussi01.com/web/factoids.cgi?db=ubuntu&search=&order=added%20DESC&page=0|By date]]
 * [[http://jussi01.com/web/factoids.cgi?db=ubuntu&search=&order=name%20ASC&page=0|Alphabetical]]
You can browse the factoids online at http://ubottu.com/factoids.cgi

 * [[http://ubottu.com/factoids.cgi?db=ubuntu&search=&order=popularity%20DESC&page=0|Most popular first]]
 * [[http://ubottu.com/factoids.cgi?db=ubuntu&search=&order=added%20DESC&page=0|By date]]
 * [[http://ubottu.com/factoids.cgi?db=ubuntu&search=&order=name%20ASC&page=0|Alphabetical]]
Line 187: Line 187:
* RSS is disabled *
Line 194: Line 195:
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 Ubottus administrator. 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 Ubottus administrator in #ubuntu-bots or #ubuntu-ops .
Line 198: Line 199:
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. 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.
Line 207: Line 208:
Replace {{{timezone}}} with your timezone. A list of valid timezones can be found on http://jussi01.com/web/timezones.html Replace {{{timezone}}} with your timezone. A list of valid timezones can be found on http://ubottu.com/timezones.html
Line 223: Line 224:
 * {{{@lart <nick> [for <reason>]}}}

==== Miscellaneous ====
To resume long messages:
 * {{{@more [nick]}}}
{{{@lart <nick> [for <reason>]}}}

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 database may be downloaded from this location.

ubot3

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

ubot5

Uses on the ubottu source and database. Ran by jpds - idles on LoCoTeam channels.

ubotu

  • Encyclopedia/Package search/RSS/Bugtracker/Bantracker/Meeting agenda/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.

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 Ubottus 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.

Meeting schedule

The meetings in #ubuntu-meeting are scheduled via The Fridge. Ubottu manages the topic in #ubuntu-meeting and keeps a list of upcoming meetings in there. To retrieve the current schedule in your local time, you can use the command

@schedule timezone

Replace timezone with your timezone. A list of valid timezones can be found on http://ubottu.com/timezones.html

Another useful command is

@now timezone

Which will display the current time and next meeting in the given timezone.

If timezone is omitted in either command it defaults to UTC/GMT

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>]

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