Duxlot is a new IRC bot created in 2012 by Sean B. Palmer, the maker of the popular Phenny. Features include a fast multiprocess based architecture, modularity, and ease of use. Duxlot has no dependencies except Python3, and will even work without having to be installed as as package.
WARNING: This is an early, pre-release alpha version of Duxlot. The API and features may change wildly, and the bot may not be stable.
Get Python 3.2 or later.
You may use either of these methods:
Download the latest source:
Unpack it and enter
duxlot-0.9.13-1700/Optionally install using:
python3 setup.py install
Optionally use virtualenv for either of these methods.
You can now use the duxlot script—either the one in the package that you downloaded, or the one that should be on your $PATH from installation.
WARNING: The entire Duxlot API is not yet stable, including the configuration file. Early adopters will find themselves having to change the configuration files often, with undocumented changes occurring.
Duxlot works by loading a JSON configuration file specified by the user. To create a default configuration file with some options filled in to work from, do:
duxlot create
This will create a file at ~/.duxlot/duxlot.json, which is the default configuration file. You can also create this file manually, if you prefer. You can then edit the file with various options recognised by Duxlot. Here's an example:
{
"server": "barjavel.freenode.net",
"nick": "duxlot001",
"channels": ["#duxlot-test"],
"prefix": "^",
"owner": "you"
}
A summary of all allowed options is given in the section below.
You can then run the bot either as a daemon:
duxlot start
Or in the foreground:
duxlot --foreground start
If you run the bot as a daemon, you will be told the PID of the daemon. You can stop the bot using the stop action:
duxlot stop
Or by sending a SIGTERM signal to the PID manually.
To find out what else the duxlot script can do, try these commands:
duxlot --help duxlot --usage
These are the allowed option fields for the configuration file:
| admins: | Nicks of people allowed to use administrative commands |
|---|---|
| channels: | List of channels to join |
| nick: | Nick for the bot to use for itself |
| nickserv: | Pass to send to NickServ services bot |
| owner: | Nick of the owner of the bot, allowed to use owner commands |
| port: | The port of the server to connect to |
| prefix: | Default prefix used across all channels for commands |
| prefixes: | Mapping of channels to their local command prefix |
| private: | Private channels where seen data should not be recorded |
| server: | The hostname of the server to connect to |
People love Phenny, the predecessor of Duxlot. Some of them have wondered how Duxlot relates to Phenny. Stay tuned for information!
Duxlot is pronounced djuːksləʊ, or dʌksləʊ, in IPA.
- David P. Kendal (@dpkendal), who helped me to debug
- Smedley Butler (@epivalent), who helped me to maintain bug isostasy
- Björn Höhrmann (@hoehrmann), who confused me into adding bugs