To use this package, run the following command in your project's root directory:
Put the following dependency into your project's dependences section:
A command-line IRC bot.
kameloso sits and listens in the channels you specify and reacts to certain events, like bots generally do. It is a passive thing and does not respond to keyboard input, though text can be sent manually by other means.
It provides a framework that works with nearly all IRC server networks, and where it doesn't it's easily extended. Featues are added as plugins written as D modules.
Networks without nickname services will face some issues, since the bot identifies people by their
AuthServ login names. As such you will probably want to register and reserve nicknames for both yourself and the bot, where available.
Current functionality includes:
- bedazzling coloured terminal output like it's the 90s
- printing of IRC events after they are parsed, all formatted and nice
- repeating text! amazing
- 8ball! because why not
- storing, loading and printing quotes from users
- saving notes to offline users that get played back when they come online
- looking up titles of pasted web URLs
- sed-replacement of the last message sent (
- piping text from the terminal to the server
- mIRC colour coding and text effects (bold, underlined, ...), translated into Bash formatting
- SASL authentication (
There are a few Windows caveats.
- Web URL title lookup may not work out of the box with secure
HTTPSconnections, due to the default installation of
dlang-requestsnot finding the correct
OpenSSLlibraries. Unsure of how to fix this.
- Terminal colours may also not work, depending on your version of Windows and likely your terminal font. Unsure of how to enable this. By default it will compile with colours disabled, but they can be enabled by specifying a different build configuration.
- Text output will not work well with the default
Cygwinterminal, due to some nuances of how it does or doesn't present itself as a
tty. There are some workarounds for most output, though they aren't exposed for now.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes, as well as general use.
You need a D compiler and the official
dub package manager. There are three compilers available; see here for an overview.
It's possible to build it without
dub but it is non-trivial if you want the
GitHub offers downloads in ZIP format, but it's easier to use
git and clone the repository that way.
$ git clone https://github.com/zorael/kameloso.git $ cd kameloso
$ dub build
This will compile it in the default
debug mode, which adds some extra code and debugging symbols. You can automatically strip these and add some optimisations by building it in
release mode with
dub build -b release. Refer to the output of
dub build --help for more build types.
Unit tests are built into the language, but you need to compile in
unittest mode for them to run.
$ dub build -b unittest
The tests are run at the start of the program, not during compilation. You can use the shorthand
dub test to compile with tests and run the program immediately.
How to use
The bot needs the nickname services login name of the administrator/master of the bot, and/or one of more home channels to operate in. It cannot work without having at least one of the two. The hardcoded defaults contain neither, so you need to create and edit a configuration file before starting.
$ ./kameloso --writeconfig
Open the new
kameloso.conf in a text editor and fill in the fields.
If you have an old configuration file and you notice missing options, such as the new plugin-specific options for the
notes plugins, just run
--writeconfig again and your file should be updated with all fields. There are many more plugin-specific and less important options available than what is displayed at program start.
Once the bot has joined a channel it's ready. Mind that you need to authorise yourself with nickname services and whitelist your master login in the configuration file before it will listen to anything you do.
you | kameloso: say herp
kameloso | herp
you | kameloso: 8ball
kameloso | It is decidedly so
you | kameloso: quote you This is a quote
kameloso | Quote saved. (1 on record)
you | kameloso: quote you
kameloso | you | This is a quote
you | kameloso: note OfflinePerson Why so offline?
kameloso | Note added
you | kameloso: sudo PRIVMSG #thischannel :this is a raw IRC command
kameloso | this is a raw IRC command
you | https://www.youtube.com/watch?v=s-mOy8VUEBk
kameloso | [youtube.com] Danish language
- "online" help; listing of verbs/commands
- add ExamplePlugin (work in progress)
- investigate inverse channel behaviour (blacklists)
- revisit "roles" (Twitch badges) because this isn't working
- test IRCv3 more
- split out Twitch bits into own
twitchplugin; need for plugins to be able to modify
IRCEventsas they are built.
- sort out
- pipedream: DCC
- update docs and wiki
- throttle sending messages, anti-flood protection
- Travis LDC tests
This project is licensed under the MIT license - see the LICENSE file for details.
- Registered by JR
- ~overflow released 4 years ago
- Copyright © 2017, JR
2.0.0 2021-Feb-02 2.0.0-rc.5 2021-Jan-01 2.0.0-rc.4 2020-Dec-23 2.0.0-rc.3 2020-Dec-01 2.0.0-rc.2 2020-Nov-07
- Download Stats:
0 downloads today
0 downloads this week
7 downloads this month
25 downloads total
- Short URL: