NAME

       willie - A highly customizable Internet Relay Chat bot

SYNOPSIS

       willie [-q|--quit] [-k|--kill] [-d|--fork] [--quiet] [-c filename |--config= filename]
       willie [-h|--help]
       willie [-m|--migrate]
       willie [-w|--configure-all] [--configure-modules] [--configure-database]

DESCRIPTION

       willie  runs  a  bot  that provides some useful (and some useless) commands in one or more Internet Relay
       Chat channels. It reads configuration options, such as the network to connect to, channels to  join,  and
       more from a config file specified by the -c option. If no config file is specified, ~/.willie/default.cfg
       is used. If the configuration file being used does not exist, a brief configuration wizard will be run to
       set  up  the  basic options, and optionally set up a database for user data and any modules that may need
       configuration.

       In most cases, simply running willie will be sufficient; the bot will start after initial  configuration,
       and will run until it is told to quit through IRC.

OPTIONS

       -h or --help
            Show a brief summary of these options.

       -c   filename or --config= filename
            Run  Willie  with  the  configuration  options  from the specified file. An absolute pathname can be
            given, or the name of a file within the configuration directory may also be given.  ~/.willie is the
            preferred  location,  but  this  and -c will also look in ~/.jenni and ~/.phenny for legacy reasons.
            When the suffix of the file is .cfg , it may be omitted.

       -d or --fork
            Run Willie in the background. The bot will safely run in the background, and  can  later  be  killed
            with -q or -d

       -q or --quit
            Gracefully  quit a daemonized instance of Willie. This option determines the instance to quit by the
            name of the config file given by the -c option, if used, so the same argument must be given with  -c
            when using -q.

       -k or --kill
            Terminates  a daemonized instance of Willie. This option determines the instance to kill by the name
            of the config file given by the -c option, if used, so the same argument must be given with -c  when
            using -k.

       -l or --list
            List  all  config  files  found  in the usual configuration file directories: ~/.willie ~/.jenni and
            ~/.phenny

       -m or --migrate
            Attempt to migrate a configuration file for an older version of the bot to the new format.  Versions
            prior to 3.1 used a configuration file written in Python, which can be converted with this tool.

       --quiet
            Suppress all output from the bot to the terminal.

       -w or --configure-all
            Run  the  initial  configuration  wizard.  This can be run with -c to configure a specified file, or
            without it to work on the default file.

       --configure-modules
            Check for modules with configuration options, and allow the user to modify  those  options.  Changes
            will be added to the default file, or the file given to -c if used.

       --configure-database
            Run  a  wizard  for  configuring the user information database options. Changes will be added to the
            default file, or the file given to -c if used.