BouncerIRC

Description

IRC Bouncer with the hackerspace tag.

• Ask Freestorm or Rorist for account creation
• Only one irc server is possible per bouncer account http://wiki.znc.in/FAQ#Networks
• You can login multiple times with the same account on different servers

Goal

• Use a private bouncer
• Enjoy a bouncer features (away nick, back log, instant attach, ...)
• Tweak it for the hackerspace needs

Configuration

• Server: hackerspace.fixme.ch:6277 with SSL
• For xchat: Server password: login:password OR login/server:password
• In case the root certificate is missing
  • https://www.startssl.com/certs/sub.class2.server.ca.crt
  • https://www.startssl.com/certs/sub.class2.server.ca.pem
• User configuration, web interface: https://hackerspace.fixme.ch:6277

Usage

• Connect to a IRC server over SSL

/msg *status AddServer irc.freenode.net +7000
/msg *status connect irc.freenode.net
/join #channel

• Basic status config

/msg *status help

• Configure buffer

/msg *status LoadMod savebuff
/msg *status LoadMod buffextras
/msg *status SetBuffer #fixme 500

• Change password

/msg *status LoadMod controlpanel
/msg *controlpanel set password mypassword

• Save config to file (important when the bouncer is restarted)

/msg *status SaveConfig

• List and add module

/msg *status ListAvailMods
/msg *status LoadMod XXX

• Complete config

/msg *status LoadMod controlpanel
/msg *controlpanel help

• Customize CTCP responses

/msg *controlpanel addctcp username COMMAND message
ex.: /msg *controlpanel addctcp rorist VERSION TskTsk

• Connect to multiple servers with one account

/msg *status addnetwork efnet
/msg *status jumpnetwork efnet
/msg *status addserver irc.efnet.org
/msg *status connect irc.efnet.org
# Connect with user/efnet:password (in xchat)
/msg *status jumpnetwork default

• Increase the number of networks per user (admin only)
  • edit /home/bouncer/.znc/configs/znc.conf
  • Increase maxnetworks to 5
  • rehash config

/msg *status rehash

NOTE: You can use /znc instead of /msg *status if your client supports it.

• Administration

/msg *controlpanel help

Custom Modules

FixMyNick

Automatic prefix nickname with custom string when attaching from a specific IP. sources
The string %nick% will automatically be replaced by the nickname set in ZNC.
You can use any part of the IP, evaluated from left to right.
SetDefaultNick sets whether you want to change your nick back to default (the one set in znc) when leaving or not.
NOTE: Please desactivate AwayNick module if you don't want your nick to be changed 2 times

/msg *status UnloadMod awaynick
/msg *status LoadMod fixmynick
/msg *fixmynick addplace 128.178.115.37 %nick%_work
/msg *fixmynick addplace 62.220.135 FIXME_%nick%
/msg *fixmynick delplace 62.220.135
/msg *fixmynick listplaces
/msg *fixmynick setdefaultnick true/false

Built-in Modules

• Interesting modules: awaynick, away, savebuff, buffextras, ...

Links

• ZNC Bouncer: http://wiki.znc.in
• C++ Modules: http://wiki.znc.in/Writing_modules
• Module docs: http://people.znc.in/~psychon/znc/doc/classCModule.html

Project Leaders

• Rorist
• FreeStorm