https://aznot.com/index.php?action=history&feed=atom&title=Willie
Willie - Revision history
2026-05-08T23:03:51Z
Revision history for this page on the wiki
MediaWiki 1.41.0
https://aznot.com/index.php?title=Willie&diff=1621&oldid=prev
Kenneth: /* Configure */
2015-01-23T15:00:15Z
<p><span dir="auto"><span class="autocomment">Configure</span></span></p>
<p><b>New page</b></p><div>== Willie ==<br />
<br />
Willie - Willie - The Python IRC Bot - http://willie.dftba.net/<br />
<br />
== Install ==<br />
<br />
Dependencies: [https://github.com/embolalia/willie/wiki/System-Requirements]<br />
sudo yum install libxml2-devel libxslt-devel enchant<br />
sudo pip install feedparser pytz lxml praw pyenchant pygeoip<br />
sudo pip install IPython<br />
<br />
Install Willie<br />
sudo pip install willie<br />
<br />
Python 2.7 has a bug, to fix:<br />
# error: ImportError: No module named backports.ssl_match_hostname<br />
sudo pip install backports.ssl_match_hostname<br />
<br />
== Execute ==<br />
<br />
To run Willie, run as a non root user:<br />
$ willie<br />
<br />
To fork (background):<br />
$ willie -f<br />
<br />
== Configure ==<br />
<br />
To configure, run as a non root user, and answer the few questions:<br />
$ willie<br />
<br />
This will create the config directory:<br />
~/.willie/<br />
~/.willie/default.cfg<br />
<br />
Note: when specifying a channel, make sure to prefix with "#"<br />
<br />
~/.willie/default.cfg<br />
<pre><br />
[core]<br />
nick = billybob<br />
host = myirc.server.com<br />
use_ssl = False<br />
port = 6667<br />
owner = billyowner<br />
channels = #billybob,#somethingelse<br />
<br />
admins = user1,user2<br />
enable = echo,help,adminchannel,autoop<br />
</pre><br />
<br />
== Usage ==<br />
<br />
.help<br />
.commands<br />
.c 5 / 2<br />
<br />
== Modules ==<br />
<br />
Note: multiple modules can be placed into the same file.<br />
<br />
<pre><br />
# ~/.willie/modules/helloworld.py<br />
import willie<br />
<br />
# .hello world<br />
@willie.module.commands('helloworld')<br />
def helloworld(bot, trigger):<br />
bot.say('Hello, world!')<br />
</pre><br />
<br />
<pre><br />
# ~/.willie/modules/echo.py<br />
import willie<br />
<br />
# .echo with arguments<br />
@willie.module.commands('echo')<br />
def echo(bot, trigger):<br />
bot.reply(trigger.group(2))<br />
</pre><br />
<br />
<pre><br />
# ~/.willie/modules/hi.py<br />
import willie<br />
<br />
# regex<br />
@willie.module.rule('hello!?')<br />
def hi(bot, trigger):<br />
bot.say('Hi, ' + trigger.nick)<br />
</pre><br />
<br />
Core modules exist here:<br />
/opt/python-2.7.9/lib/python2.7/site-packages/willie/modules/<br />
<br />
References:<br />
* Willie tutorial, Part 2 · embolalia/willie Wiki · GitHub - https://github.com/embolalia/willie/wiki/Willie-tutorial%2C-Part-2<br />
<br />
== Core Modules ==<br />
<br />
Core modules exist here:<br />
/opt/python-2.7.9/lib/python2.7/site-packages/willie/modules/<br />
<br />
<pre><br />
adminchannel.py - op, deop, <br />
admin.py<br />
announce.py<br />
bugzilla.py<br />
calc.py<br />
chanlogs.py<br />
clock.py<br />
countdown.py<br />
currency.py<br />
dice.py<br />
etymology.py<br />
find.py<br />
find_updates.py<br />
github.py<br />
help.py - help, commands<br />
ip.py<br />
ipython.py<br />
isup.py<br />
lmgtfy.py<br />
meetbot.py<br />
movie.py<br />
ping.py<br />
radio.py<br />
rand.py<br />
reddit.py<br />
reload.py<br />
remind.py<br />
rss.py<br />
safety.py<br />
search.py<br />
seen.py<br />
spellcheck.py<br />
tell.py<br />
tld.py<br />
translate.py<br />
unicode_info.py<br />
units.py<br />
uptime.py<br />
url.py<br />
version.py<br />
weather.py<br />
wikipedia.py<br />
wiktionary.py<br />
xkcd.py<br />
youtube.py<br />
</pre><br />
<br />
== Custom Modules ==<br />
<br />
=== admins can op themselves ===<br />
<br />
Owner/Admins can op themselves<br />
<pre><br />
--- adminchannel.py.old 2015-01-22 15:12:31.893968888 -0700<br />
+++ adminchannel.py 2015-01-22 15:11:25.985975053 -0700<br />
@@ -37,8 +37,12 @@<br />
Command to op users in a room. If no nick is given,<br />
willie will op the nick who sent the command<br />
"""<br />
- if bot.privileges[trigger.sender][trigger.nick] < OP:<br />
- return<br />
+ #if bot.privileges[trigger.sender][trigger.nick] < OP:<br />
+ # return<br />
+ if not (trigger.nick == bot.config.owner or<br />
+ trigger.nick in bot.config.admins.split(',') or<br />
+ bot.privileges[trigger.sender][trigger.nick] == OP):<br />
+ return<br />
if bot.privileges[trigger.sender][bot.nick] < OP:<br />
return bot.reply("I'm not a channel operator!")<br />
nick = trigger.group(2)<br />
</pre><br />
<br />
=== auto op admins ===<br />
<br />
<pre><br />
# ~/.willie/modules/autoop.py<br />
import willie<br />
<br />
@willie.module.event('JOIN')<br />
@willie.module.rule('.*')<br />
def autoop(bot, trigger):<br />
nick = trigger.nick<br />
channel = trigger.sender<br />
if bot.privileges[channel][bot.nick] < willie.module.OP:<br />
return # not a channel operator!<br />
if (nick == bot.config.owner or<br />
nick in bot.config.admins.split(',')):<br />
bot.say('Hi, ' + trigger.nick)<br />
bot.write(['MODE', channel, "+o", nick])<br />
</pre><br />
<br />
== keywords ==<br />
<br />
[[Category:IRC]]</div>
Kenneth