welcomebot/README.md

39 lines
2.7 KiB
Markdown
Raw Normal View History

2014-02-08 18:14:12 +01:00
## What is this?
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
oh-irc-bot (or "WelcomeBot", its IRC nick) is a bot for welcoming people into the #openhatch irc channel
2013-12-21 22:14:36 +01:00
when no one is paying attention. The goals are to:
2014-03-10 20:44:28 +01:00
1. alert community members when someone new enters the room and says hello (either by using their nick
2013-12-21 22:14:36 +01:00
in a response, or by sending a private message)
2014-02-08 18:14:12 +01:00
2. help a person to feel welcome even when there's no one around, and providing more information about
2013-12-21 22:14:36 +01:00
staying in touch
2014-02-08 18:14:12 +01:00
## Basic Structure
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
<code>bot.py</code> is the project's main file. It uses the socket module to communicate and gathers a list of known IRC nicknames, stored in <code>nicks.csv</code>. Its basic functions include:
2013-12-21 22:14:36 +01:00
1. If someone enters the channel, the bot checks to see if they are a known nick. If not, it adds them to a list of people to greet. If no one else has spoken into the channel after a period of time, 60 seconds by default, it greets them. If someone else (not the new nick) speaks into the channel within the set wait time, or if the nick is known, the bot remains silent. The bots response text includes the nicks of channel maintainers/frequent contributors so that they are pinged. Channel maintainers can change the wait time of the bot by using the following command in the irc channel: *Botname* --wait-time *new wait time in seconds*.
2014-02-08 18:14:12 +01:00
2. If someone says hello to the bot, the bot says hello back.
3. If someone asks the bot for information (via key phrases like "help", "faq", etc) the bot explains what it is and links to this repository.
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
## Setting up
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
To run the bot:
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
1. Download the repository. If you need help using github, see [here](https://openhatch.org/wiki/Git_Basics).
2. Edit bot.py to change the nickname to something besides "WelcomeBot" and the channel to "openhatch-bots".
2. Open up a command line and type <code>python bot.py</code>.
3. Although all IRC messages should be printed to your command line, for development purposes, it will probably be useful to be on IRC separately using your normal nick.
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
If you run into setup difficulties, ping shauna on freenode (via the #openhatch channel is preferred) and/or leave an issue in this repository's issue tracker.
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
## How to help
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
The [issue tracker](https://github.com/shaunagm/oh-irc-bot/issues?state=open) lists improvements we want to make. Please feel free to submit pull requests to address these issues. If you're not familiar with how to do this using github, see [here](https://openhatch.org/wiki/Git_Basics). You can also ask me for clarification (again, I am shauna on the #openhatch IRC.)
2013-12-21 22:14:36 +01:00
2014-02-08 18:14:12 +01:00
## Credit
2013-12-21 22:14:36 +01:00
2013-12-22 03:40:59 +01:00
This bot was adapted from code found [here](http://wiki.shellium.org/w/Writing_an_IRC_bot_in_Python).
Also [this](http://docs.python.org/2/library/queue.html) has been very helpful.