The bot running to bridge tildes as needed.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
str4d 19dea6cfd9
Add support for relaying via webhooks
5 years ago
.gitignore Initial config file implementation. Doesn't include nickname. 9 years ago
README.md Fix readme and config sample. 6 years ago
relaybot.config_sample Add support for relaying via webhooks 5 years ago
relaybot.py Add support for relaying via webhooks 5 years ago
run.sh Support for and script to make it easier to run with twistd. 9 years ago

README.md

RelayBot

A two-way IRC bridge bot for bridging multiple arbitrary IRC channels. It is written in Python and uses Twisted. It is based off of relaybot, and aims to be less complicated by doing less.

This was written as I gutted relaybot while trying stop the second relay bot from failing to connect, preventing the relay from functioning. As such, it does not provide relaybot's support for runtime configuration changes or passworded channels. The design does not unduly impede the implementation of these abilities if need be. Unlike relaybot, RelayBot allows connecting to different ports on the same host simultaniously.

This distribution includes run.sh for easier control of the daemon.

Modes

  • Default: simple two-way relaying.
  • NickServ: authenticates with nickserv before joining channels.
  • FLIP: specialized mode for FLIP which removes the numbered suffix on outgoing usernames.
  • RelayByCommand: only messages with the bot's name followed by a colon will be relayed.

Requirements

  • Python 2.6.6-ish or higher
  • Twisted: pip install Twisted

Usage

Edit the sample config file as desired. If no local value exists for a section and the default is not defined, startup will fail.

sh run.sh start

Internals

On startup, the config file is read, and for each section the local entry is preferred over the default one. For each defined host, an instance of IRCRelay or a subclass thereof (depending on mode) connects to the host and joins the channel. Each instance relays events to the others though a global Communicator class with which it registers. When the bot recieves a message, if it is to the channel it relays it.