To create new wiki account, please join us on #znc at freenode or efnet and ask admins to create a wiki account for you.

ZNC

From ZNC
Revision as of 16:12, 1 April 2013 by Un1matr1x (Talk | contribs) (News: License switch soon)

Jump to: navigation, search

Welcome to the ZNC wiki where you may find and publish information about ZNC, an advanced IRC bouncer that is left connected so an IRC client can disconnect/reconnect without losing the chat session. Feel free to update pages which you think are improvable and don't hesitate to ask for help.

Znc-0.99-black.png

You can find us in #znc on EFNet or on freenode.

The latest stable release is 1.4 (ChangeLog).

News: License switch soon

ZNC is going to switch license from GPLv2 to Apache 2.0. It will allow us to use various third-party libraries which can't be used currently. If you feel that you have some comments or concerns about the change, please join us at our IRC channels, #znc on EFNet, freenode or leave a comment at GitHub.

If you have contributed code to ZNC, please join us and explicitly agree or disagree with the change, otherwise we'll need to revert/rewrite your code.

Download ZNC 1.4

You can find the latest stable release here!

Or you can try testing version, using git!

How does it work?

  • Install ZNC on your server.
  • Generate an initial configuration via znc --makeconf.
    • (0.206 and earlier)
      • For each IRC network, you need to create a ZNC user.
      • For example, use one user for Freenode, one user for EFnet, one user for Quakenet, etc.
    • (1.0)
      • Each ZNC user can connect to several IRC networks, though you'll need to connect your IRC client to ZNC several times.
    • You can later change settings (add more users, tune existing ones, etc.) via the web interface or from IRC.
  • Configure your IRC client to connect to your ZNC server.
    • It's a good idea to use username/network:password as the password in your client, so that (even for broken clients) ZNC can figure out which user you are connecting as.
  • Read the FAQ if you run into any problems. Feel free to ask on IRC if you need more help.
  • Enjoy! (Profit?)

Main Features

Screenshot of the Webadmin module in action
Modules 
ZNC supports dynamic loading of C++, Perl, Python and Tcl modules. To get a list of the available modules and more information follow the link.
Detaching 
ZNC will remain connected to IRC even while you are offline. You can then reattach later and catch up with what happened while you were gone, and your nick (and operator status) will have been kept for you.
Multiple Users 
You can add additional users under one running process. Useful for public shells that limit background processes.
Multiple Networks 
Each user can connect to several IRC networks at once, with an optional limit configured by ZNC admin.
Multiple Clients 
Connect to the same user/network with as many clients as you want.
Playback Buffers 
Stay up-to-date with what happened and when it happened while you were detached, timestamps are also printed and can be manually configured.
SSL Support 
Encryption for both the listen port and connecting to IRC servers. If your system has OpenSSL, ZNC automatically supports SSL connections.
IPv6 Support 
Both IPv4 and IPv6 address families just work, if your system supports them.
Partyline 
Using the global partyline module, you can join channels and query users on the internal ZNC network
Web Administration 
Using the global webadmin module, admins can add/remove/edit users and global settings and non admins can edit their own user settings.

Getting started

Further Info

Writing modules

External Links

Please note that as of February 2011 we have abandoned SourceForge and moved to GitHub.