SYNOPSISwillie [-q|--quit] [-k|--kill] [-d|--fork] [--quiet] [-c filename |--config= filename]
willie [-w|--configure-all] [--configure-modules] [--configure-database]
DESCRIPTIONwillie runs a bot that provides some usefull (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.
- -h or --help
- Show a brief summary of these options.
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.
- 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.
- 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.
Run a wizard for configuring the user information database options. Changes
will be added to the default file, or the file given to