macarena

A relay bot for IRC channels spanning many networks.

Usage

From Binary

$ tar xf downloaded-tarball
$ cd macarena-$VERSION-linux-amd64
$ cp example.conf.json config.json
$ ./run.sh

From Source

$ git clone github.com/Xe/macarena
$ gb build all
$ cp src/config/example.conf.json somewhere.json
$ ./bin/macarena -conf somewhere.json

Without gb

$ ./build.sh

Please be sure to edit your config. See this for help.

Via Docker

Files

The dockerfile:

FROM xena/macarena

and the configuration:

{
        "networks": [
                {
                        "name": "PonyChat",
                        "host": "irc.ponychat.net",
                        "port": 6697,
                        "ssl":  true,
                        "pass": "foobang"
                },
                {
                        "name": "ShadowNET",
                        "host": "172.17.0.10",
                        "port": 6667,
                        "ssl":  false,
                        "pass": "foobang",
                        "bindhost": "172.17.0.1"
                }
        ],
        "myinfo": {
                "nick": "Macarena",
                "user": "relay",
                "real": "IRC Relay bot",
                "notify_connections": true
        },
        "channels": ["#macarena"]
}

The two files in the example/ folder in the root of this repository should allow you to make a suitable example deployment. PLEASE CHANGE THE CHANNEL, NICK, USER, AND NETWORK SETTINGS.

Running

Simply run:

$ docker build -t yourbot .
$ docker run -dit --name yourbot yourbot

Notes

Macarena does not detach from the active console. As such it is suggested to run macarena inside dtach, screen, tmux, as a service with upstart/systemd, or as a container.

Please use gb for building macarena. Please ensure all code passes a build before pull requesting.

Support

For help, please connect to irc.ponychat.net and join #macarena, or open a github issue on the main repository.