Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

IRC<->XMPP relay. Designed to work well with Gtalk.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 src
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 README.markdown
Octocat-spinner-32 settings.conf.example
README.markdown

dIRCbot

Introduction

This bot relays messages between IRC and Jabber/XMPP/Gtalk. It will also relay private messages.

Installation

Create a file called settings.conf in the same directory as your jar file. The easiest thing will most likely be if you base in on the settings.conf.example file that can be found in this repository.

After that type this to run the program:

 java -jar dircbot.jar

I suggest that you run this program with screen.

Configuration

Use settings.conf.example as a base for a new example file. The example file needs to be placed in the same folder as the jar-file.

Most of the settings are self-explanatory except perhaps the optional option XMPPTRUSTEDSENDER. This option is basically tells dIRCbot to ignore all users that have this prefix in their nickname.

So lets say that you set the option to "al" and have three users in an IRC channel named "al-2", "al" and "bob". dIRCbot will now only relay messages from the user bob.

A list of supported encodings can be found here.

Commands

IRC-commands

The following commands can only be run by XMPPTRUSTEDSENDER. They need to be written in the IRC channel.

  • !time displayes the current time.
  • !help shows a quick help message.
  • !stop stops forwarding messages.
  • !start resumes forwarding messages.

XMPP-commands

The following commands can only be sent from the XMPP client.

  • STOP stops forwarding messages from the IRC channel to the XMPP client.
  • START resumes forwarding messages.
  • STATUS tells you if message forwarding is turned on or off.
  • USERS shows a list of users connected to the channel.
  • RECONNECT disconnects from the IRC server and connects back to it.

Required libraries

The following libraries are required to be able to compile the source code:

Contact

If there's anything else, feed free to contact me at davor@davor.se

Something went wrong with that request. Please try again.