Mac OS X Guide

From Botnix
Jump to: navigation, search

What you need

  • Perl
  • Some additional modules (Socket6, SHA1 Hash support)
  • Developer tools for your version of OS X

How to install the prerequisites

First, install the developer tools. This is as simple as inserting the OS X CD or DVD and installing XCode Tools. Once this is done, and it can take a while, you're done. Next, open a Terminal. We'll use this to check on a couple of things before continuing.

Run the following commands inside the terminal

perl --version

This should respond with the following

This is perl, v5.8.6 built for darwin-thread-multi-2level
(with 2 registered patches, see perl -V for more detail)
Copyright 1987-2004, Larry Wall

along with some other info. The perl version you're looking for is either 5.6 or 5.8

make --version

GNU Make 3.80
Copyright (C) 2002  Free Software Foundation, Inc.

This means all the required software is installed and waiting. Now, we need the support modules for Botnix

Run the following command from the terminal

sudo cpan

If this is the first time you've run the CPAN module tool, it will ask you to configure it. The defaults are pretty safe, but if you have more powerful hardware then there are opportunities to use that power as you go through.

Once you've configured CPAN, use the following commands to install the support modules.

install Socket6
install Digest::SHA1

Additionally, for SSL support, you will want the following:

install Net::SSLeay

All done for the support modules now

Installing Botnix

  • Download the software from the website (obviously)
  • Extract it to a suitable place with either Stuffit Expander, a command line tool, or the rather inelegantly named BOMArchiveHelper. This should just be a case of opening the archive and letting it sort itself out.

You should end up with a folder called Botnix, with the following items inside it:


along with some folders.


The configuration process is the same as the other operating systems supported. See Example Configuration for details. Basically, you need to set up a block for each network you need to connect to, with a bunch of channels inside it.

What now?

Start your bot, with the command


and it should start up and await instruction on the IRC networks you configured

Botnix 0.4.5
Failed to open userfile 'botnix.uf', starting in first-use mode.
To create an owner account on the bot, please message it
the initialization command, as follows:
/msg <bot nick> init-8084638
Done, switching to background using fork...

Enter that command on the IRC network, and you will recieve a message telling you your password. Use this when you need the bot to talk to you, or to send it commands.