IRC daemon, notifier, bot, TUI client, and its frontends
Go to file
Přemysl Eric Janouch 295e4c8bf9 degesch: preparations for numerics processing 2015-04-21 22:08:18 +02:00
liberty@8c6d18757d Bump liberty 2015-03-29 03:46:13 +02:00
plugins Fix the YouTube plugin 2015-02-23 09:48:08 +01:00
.gitignore Miscellaneous tiny changes 2015-02-28 20:08:05 +01:00
.gitmodules Move to liberty 2015-02-28 20:09:51 +01:00
.travis.yml Travis CI: Change IRC notification address 2015-04-10 03:17:01 +02:00
CMakeLists.txt degesch: preparations for numerics processing 2015-04-21 22:08:18 +02:00
LICENSE Convert to CMake 2015-02-11 01:53:19 +01:00
README Add a stubbed IRC client 2015-04-11 21:05:13 +02:00
common.c Prepare for a custom logger in degesch 2015-04-11 21:12:56 +02:00
config.h.in Convert to CMake 2015-02-11 01:53:19 +01:00
degesch.c degesch: preparations for numerics processing 2015-04-21 22:08:18 +02:00
kike-gen-replies.sh kike: fix the Makefile 2014-08-10 03:46:49 +02:00
kike-replies kike: generate replies from a single text file 2014-08-10 00:47:26 +02:00
kike.c Prepare for a custom logger in degesch 2015-04-11 21:12:56 +02:00
zyklonb.c Move the SOCKS code to common.c 2015-04-11 21:09:06 +02:00

README

ZyklonB
=======

`ZyklonB' is an experimental IRC bot, building upon the concept of my other
VitaminA IRC bot.  The main characteristic of these two bots is that they run
plugins as coprocesses, which allows for enhanced reliability and programming
language freedom.

While originally intended to be a simple C99 rewrite of the original bot, which
was written in the GNU dialect of AWK, it fairly quickly became a playground
where I added everything that seemed nice.

kike
----
Also included is a simple IRC daemon that mostly follows the RFC's but is
limited to single-server networks, due to the protocol being incredibly ugly and
tricky to implement correctly (the poor quality of the RFC's doesn't help).  It
is designed for use as a regular user application rather than a system daemon.

It is complete enough to be useful but there are still some things that need to
be resolved before I can consider it stable.

Some interesting features:
 - SSL/TLS autodetection
 - IRCop authentication through SSL/TLS client certificates
 - epoll support on Linux
 - superfast build time, small memory footprint

degesch
-------
To complete it all, I've also started working on an IRC client.  I thought it
would be interesting to build an IRC client on top of libreadline.  Also way
simpler than doing it in ncurses.

Building
--------
Build dependencies: CMake, pkg-config, help2man, awk, sh, liberty (included)
Runtime dependencies: openssl, ncursesw (degesch), readline (degesch)

 $ git clone https://github.com/pjanouch/ZyklonB.git
 $ git submodule init
 $ git submodule update
 $ mkdir build
 $ cd build
 $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
 $ make

To install the application, you can do either the usual:
 # make install

Or you can try telling CMake to make a package for you.  For Debian it is:
 $ cpack -G DEB
 # dpkg -i ZyklonB-*.deb

Note that for versions of CMake before 2.8.9, you need to prefix cpack with
`fakeroot' or file ownership will end up wrong.

Running
-------
First you might want to generate a configuration file:
 $ zyklonb --write-default-config
 $ kike --write-default-config

After making any necessary edits to the file (there are comments to aid you in
doing that), simply run the appropriate program with no arguments:
 $ zyklonb
 $ kike

ZyklonB stays running in the foreground, therefore I recommend launching it
inside a Screen or tmux session.  kike, on the other hand, immediately forks
into the background.  Use something like `killall' if you want to terminate it.

Client Certificates
-------------------
`kike' uses SHA1 fingerprints of SSL client certificates to authenticate users.
To get the fingerprint from a certificate file in the required form, use:
 $ openssl x509 -in public.pem -outform DER | sha1sum

Disclaimer
----------
I am not an antisemitist, I'm just being an offensive asshole with the naming.
And no, I'm not going to change the names.

License
-------
`ZyklonB' is written by Přemysl Janouch <p.janouch@gmail.com>.

You may use the software under the terms of the ISC license, the text of which
is included within the package, or, at your option, you may relicense the work
under the MIT or the Modified BSD License, as listed at the following site:

http://www.gnu.org/licenses/license-list.html