# Relay-Bot

**Category:** Standalone_Bot
**Original Author:** Eric Eisenhart, Devin Carraway

## Description
Relay-Bot is a Perl script designed to relay messages between multiple IRC networks. It allows users to maintain a single channel across different networks and automatically forwards messages from one network to the others.

## Key Features
- **Message Relaying**: Automatically relays public messages, private messages, actions, joins, parts, nick changes, kicks, topic changes, and user mode changes.
- **Configuration Management**: Supports configuration through a `relay-bot.config` file for specifying channels, networks, and relaying permissions.
- **Daemon Mode**: Can run in the background using a shell script wrapper.
- **Join/Part Commands**: Allows joining or parting from multiple channels across different networks via commands.

## File Analysis
- **relay-bot.pl** — Main Perl script that handles message relaying and configuration parsing.
- **relay-bot.sh** — Shell script to daemonize the `relay-bot.pl` process.
- **INSTALL** — Instructions for installation, including dependencies on Perl and Net::IRC module.
- **LICENSE** — License information allowing redistribution under terms of either GNU GPL or Artistic License.
- **README** — Documentation detailing usage, configuration, and rationale behind the script's development.
- **AUTHORS** — List of authors who contributed to the project.
- **Artistic** — Full text of the "Artistic License".
- **BUGS** — Known issues with the software.
- **ChangeLog** — History of changes made to the script from 2002 to 2006.
- **ChangeLog.bak** — Backup version of the `ChangeLog` file.
- **GPL** — Full text of the GNU General Public License.