Multi user IRC bouncer
npm install kiwibnc* Stay connected to IRC. For one person or 10,000 people
* Zero downtime updates and restarts. Don't knock everyone offline because an update is available
* Extensible via javascript plugins
* Use with older or modern IRCv3 clients
* Message storage via sqlite database
* RabbitMQ support for larger deployments
For general usage it is working and is currently being put to the test in live environments. However, as we learn more on how people use the project things may change at the moment.
shell
$ git clone https://github.com/kiwiirc/kiwibnc.git
$ cd kiwibnc
$ npm install
`Usage
After installing, take a glance over and make sure it suits your needs. It should work out of the box for most people.#### Add a user
`shell
$ npm start adduser> statebnc@1.0.0 start /home/kiwibnc
> node src/server.js "adduser"
01:09:17 [adduser] l_info ## Starting adduser ##
01:09:17 [adduser] l_info Using config file ./config.ini
Username: someuser
Password: **
Admin account? n
Added new user someuser
`#### Starting the bouncer
shell
$ npm start
`#### Adding networks and controlling your bouncer
Connect to your bouncer via your IRC client. Your password should be in the form of
. Once connected you will receive a private message from *bnc - this is your bouncer control buffer.`
01:12 -!- Irssi: Starting query in localhost with *bnc
01:12 <*bnc> Welcome to your BNC!
01:12 addnetwork
01:12 <*bnc> Usage: addnetwork name=example server=irc.example.net port=6697 tls=yes nick=mynick
01:12 <*bnc> Available fields: name, server, port, tls, nick, username, realname, password
01:12 addnetwork name=freenode server=irc.freenode.net port=6667 nick=somenick
01:12 <*bnc> New network saved. You can now login using your_username/freenode:your_password
Send
to *bnc` for all the commands you can send.