# irccat

**Category:** Standalone_Bot
**Original Author:** Richard Jones <rj@last.fm>

## Description
irccat is a standalone IRC bot that listens for incoming data on a specified port, forwards it to an IRC channel, and can execute external scripts based on commands issued in IRC.

## Key Features
- Listens for incoming data on a specific IP:port and sends it to an IRC channel.
- Executes external scripts for handling IRC commands.
- Supports configuration via `irccat.xml`.

## File Analysis
- **irccat.sh** — Entry point script that starts the bot using Ant.
- **irccat.py** — Python plugin for Trac, sending ticket changes to IRC.
- **command_runner.py** — Script handler for executing external commands in IRC.
- **example.php** — Example PHP script handling IRC commands.
- **example.sh** — Shell script wrapper for running the example PHP script.
- **twitter-feed.php** — Script for fetching and displaying Twitter search results on IRC.
- **LICENSE** — GNU General Public License v2.0.
- **README.md** — Documentation for irccat, including installation instructions.
- **README.txt** — JIRA listener plugin documentation.
- **README** — Outdated README file with a link to Google Code project.
- **.gitignore** — Git ignore configuration.
- **build.xml** — Ant build script for compiling and packaging the bot.
- **.classpath** — Eclipse classpath configuration.
- **.project** — Eclipse project description.
- **pom.xml** — Maven project file.
- **IrccatListener.java** — JIRA listener plugin Java code.
- **UnitTestMyPlugin.java** — Unit test for the plugin.
- **IntegrationTestMyPlugin.java** — Integration test for the plugin.
- **TEST_RESOURCES_README.txt** — README for test resources.
- **IntegrationTestData.xml** — XML file for integration test data.
- **irccat.xml** — Configuration file for irccat.
- **irccat** — SysV init script for starting and stopping the bot.