CVNBot

From Meta, a Wikimedia project coordination wiki
(Redirected from SWMTBot)

CVNBot (previously known as SWMTBot) is the main IRC bot software used by the Countervandalism Network to interpret recent changes streams and provide a feed on IRC for patrollers to work from.

Lists[edit]

All global lists are automatically synchronised across the bots in the network (through the broadcast channel). Local lists are stored in the local database only. There is a global article watchlist for all wikis, and one for each one; you can add/delete/show items on the global list by leaving out the "p=" parameter (see the command lists below for more information).

Global lists[edit]

  • Bad new usernames (BNU)
  • Bad new article titles (BNA)
  • Bad edit summaries (BES)
  • User whitelist (WL)
  • User blacklist (BL)
  • User greylist (GL)
  • Global article watchlist (CVP)

Local per-wiki lists[edit]

  • Lists of admins (AL)
  • Lists of bots (BOTS)
  • Article watchlists (CVP)

Commands[edit]

Only voiced users (aka +) can use these commands, with the exception of control commands which are restricted to operators only (aka @).

Special parameters[edit]

The duration is measured in number of hours. x=24 will make the entry active for 24 hours (1 day). In all list commands a duration value of 0 is used to indicate that the entry should be active indefinitely (until it is changed or removed). Otherwise the entry will expire (removed from the database) after the set duration.

The default duration is 0 for all lists, except for blacklist where the entries expire after a duration of 744 hours by default (31 days). A common value is x=9000 which corresponds to approximately 1 year (9000 hours is 375 days, is 1.02 years).

For regex parameters, if you do not know what regex means, don't use regex commands. It could potentially cause of a lot of problems in the network by using it wrong, because commands that use regex can easily trigger an automatic greylisting of thousands of accounts and IP addresses at once and thus flood patroller's channels.

Info commands[edit]

Command Description Example
status When the last message was received from the source. SampleBot status
config Version of the bot and the currently loaded configuration (2 lines). SampleBot configSampleBot settingsSampleBot version
bleep wikiname Finds out which bot monitors a particular project. You can issue this command to any networked bot to receive the same results. SampleBot bleep en.wikipedia
count Finds out how many wikis each bot monitors, and each bot's version. You can issue this command to any networked bot to receive the same results. SampleBot count
list Returns a list of all currently monitored wikis. SampleBot list
help Link to this documentation page. SampleBot help

List commands[edit]

Command Description Example
bl action username [x=duration] [r=reason] Add (add), delete (del), or show (show) an item on the global blacklist. Set x=0 to make indefinite. SampleBot bl add 80.10.20.123

SampleBot bl del MrVandal

SampleBot bl add MrVandal r=Vandal on nl.wikipedia

gl del username Delete an item from the (global) greylist. SampleBot gl del MrVandal
wl action username [x=duration] [r=reason] Add, delete, or show an item on the global whitelist. Same as bl
al action username p=wikiname [x=duration] [r=reason] Add, delete, or show an item on the admin list for a particular wiki. SampleBot al add MrGood p=en.wikipedia
bots action username p=wikiname [x=duration] [r=reason] Add, delete, or show an item on the bot list for a particular wiki. Same as al
cvp add/del/show pagetitle [p=wikiname] [x=duration] [r=reason] Add, delete, or check a page on the watchlist. Use without p= for the global watchlist over all wikis. The default duration is x=0, for indefinite. SampleBot cvp add Main Page

SampleBot cvp add Main Page x=24

SampleBot cvp add Main Page p=en.wikipedia

SampleBot cvp add Main Page p=en.wikipedia x=24

SampleBot cvp show Main Page

SampleBot cvp show Main Page p=en.wikipedia

SampleBot cvp del Main Page

SampleBot cvp del Main Page p=en.wikipedia

bnu add/del/show regex [x=duration] [r=reason] Add, delete, or check a "Bad New Username" pattern (regex). These are always global. The default duration is x=0, for indefinite. SampleBot bnu add Sh.t r=Watch account creation like Shat, or Shot.

SampleBot bnu add Sh.?t r=Watch account creation like Sht, Shat, or Shot.

SampleBot bnu add Sh.*t r=Watch account creation like Sht, Shalalit, or Shower Kit.

SampleBot bnu show Sh.it

SampleBot bnu del Sh.it

bna add/del/show regex [x=duration] [r=reason] Add, delete, or check a "Bad New Article" pattern (regex). These are always global. The default duration is x=0, for indefinite. SampleBot bna add Sh.t r=Watch page creation like Shat, or Shot.

SampleBot bna add Sh.?t r=Watch page creation like Sht, Shat, or Shot.

SampleBot bna add Sh.*t r=Watch page creation like Sht, Shalalit, or Shower Kit.

SampleBot bna show Sh.it

SampleBot bna del Sh.it

bes add/del/show regex [x=duration] [r=reason] Add, delete, or check a "Bad Edit Summary" pattern (regex). These are always global. The default duration is x=0, for indefinite. SampleBot bes add Sh.t r=Watch edits with summary like Shat, or Shot.

SampleBot bes add Sh.?t r=Watch edits with summary like Sht, Shat, or Shot.

SampleBot bes add Sh.*t r=Watch edits with summary like Sht, Shalalit, or Shower Kit.

SampleBot bes show Sh.it

SampleBot bes del Sh.it

intel username Shows the item on the list (listname, adder, duration and reason) if it's listed somewhere. SampleBot intel ZooFari (ZooFari is on commons.wikimedia admin list, added by SampleBot until the end of time ("Auto-download from wiki"))
SampleBot intel Krinkle (Krinkle is on global whitelist, added by ZooFari until the end of time ("trusted"))

Control commands[edit]

Command Description Example
quit Quits the bot SampleBot quit
restart Restarts the bot SampleBot restart
load wikiname [interwiki] Add a wiki to the monitor. SampleBot load en.wikipedia

SampleBot load meta.wikimedia m:

SampleBot load nl.wikimedia nl:chapter:

SampleBot load sv.wikiquote q:sv:

drop wikiname Stop monitoring a wiki. SampleBot drop en.wikipedia
purge wikiname Removes all user list information in the database pertaining to this wiki. SampleBot purge en.wikipedia
msgs Rebuilds message cache from the Console.msgs file. Only necessary when the file has changed. This automatically hapends on restart, so only use it if the messages file has changed while the bot is running without, and want the bot to start using the new version without restarting it. SampleBot msgs
reload wikiname Rebuilds wiki cache from the wiki over HTTP. Use this if any of the log entry message templates have changed (either by MediaWiki software update or due to a local override by the wiki administrators). SampleBot reload en.wikipedia
batchreload Performs the reload command for all currently monitored wikis. Fairly resource-intensive and thoroughly not recommended. SampleBot batchreload
getadmins wikiname Downloads a list of admins from the specified project and automatically adds it to the CVNBot database. SampleBot getadmins en.wikipedia
getbots wikiname Downloads a list of flagged bots from the specified project and automatically adds it to the CVNBot database. SampleBot getbots en.wikipedia
batchgetusers Performs getadmins and getbots for all currently monitored wikis. SampleBot batchgetusers

See also[edit]