Difference between revisions of "BouncerIRC"

From Fixme.ch
Jump to: navigation, search
 
(26 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Ongoing_Projects]]
+
[[Category:Closed_Projects]]
  
 
= Description =
 
= Description =
 
IRC Bouncer with the hackerspace tag.
 
IRC Bouncer with the hackerspace tag.
  
* Server: '''hackerspace.fixme.ch:6277''' with SSL (self signed)
 
 
* Ask Freestorm or Rorist for account creation
 
* Ask Freestorm or Rorist for account creation
 +
* <s>Only one irc server is possible per bouncer account</s> http://wiki.znc.in/FAQ#Networks
 +
* You can login multiple times with the same account on different servers
  
 
= Goal =
 
= Goal =
Line 11: Line 12:
 
* Enjoy a bouncer features (away nick, back log, instant attach, ...)
 
* Enjoy a bouncer features (away nick, back log, instant attach, ...)
 
* Tweak it for the hackerspace needs
 
* 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 =
 
= Usage =
 
* Connect to a IRC server over SSL
 
* Connect to a IRC server over SSL
<pre>
+
/msg *status AddServer irc.freenode.net +7000
/msg *status AddServer irc.freenode.net +7000
+
/msg *status connect irc.freenode.net
</pre>
+
/join #channel
 
* Basic status config
 
* Basic status config
<pre>
+
/msg *status help
/msg *status help
+
* Configure buffer
</pre>
+
/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)
 
* Save config to file (important when the bouncer is restarted)
<pre>
+
/msg *status SaveConfig
/msg *status SaveConfig
+
</pre>
+
 
* List and add module
 
* List and add module
<pre>
+
/msg *status ListAvailMods
/msg *status ListAvailMods
+
/msg *status LoadMod XXX
/msg *status LoadMod XXX
+
</pre>
+
 
* Complete config
 
* Complete config
<pre>
+
/msg *status LoadMod controlpanel
/msg *status LoadMod admin
+
/msg *controlpanel help
/msg *admin help
+
</pre>
+
 
* Customize CTCP responses
 
* Customize CTCP responses
<pre>
+
/msg *controlpanel addctcp username COMMAND message
/msg *admin addctcp username COMMAND message
+
ex.: /msg *controlpanel addctcp rorist VERSION TskTsk
ex.: /msg *admin addctcp rorist VERSION TskTsk
+
* Connect to multiple servers with one account
</pre>
+
/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.
 
'''NOTE:''' You can use ''/znc'' instead of ''/msg *status'' if your client supports it.
 +
* Administration
 +
/msg *controlpanel help
  
 
= Custom Modules =
 
= Custom Modules =
Line 46: Line 66:
 
Automatic prefix nickname with custom string when attaching from a specific IP. [https://gitorious.org/znc-bouncer/fixmynick sources]<br/>
 
Automatic prefix nickname with custom string when attaching from a specific IP. [https://gitorious.org/znc-bouncer/fixmynick sources]<br/>
 
The string %nick% will automatically be replaced by the nickname set in ZNC.<br/>
 
The string %nick% will automatically be replaced by the nickname set in ZNC.<br/>
You can use any part of the IP, evaluated from left to right.
+
You can use any part of the IP, evaluated from left to right.<br/>
 +
'''SetDefaultNick''' sets whether you want to change your nick back to default (the one set in znc) when leaving or not.<br/>
 +
'''NOTE:''' Please desactivate AwayNick module if you don't want your nick to be changed 2 times
 
<pre>
 
<pre>
 +
/msg *status UnloadMod awaynick
 
/msg *status LoadMod fixmynick
 
/msg *status LoadMod fixmynick
 
/msg *fixmynick addplace 128.178.115.37 %nick%_work
 
/msg *fixmynick addplace 128.178.115.37 %nick%_work
Line 53: Line 76:
 
/msg *fixmynick delplace 62.220.135
 
/msg *fixmynick delplace 62.220.135
 
/msg *fixmynick listplaces
 
/msg *fixmynick listplaces
 +
/msg *fixmynick setdefaultnick true/false
 
</pre>
 
</pre>
  
Line 58: Line 82:
 
* Interesting modules: awaynick, away, savebuff, buffextras, ...
 
* Interesting modules: awaynick, away, savebuff, buffextras, ...
  
= Liens =
+
= Links =
 
* ZNC Bouncer: http://wiki.znc.in
 
* ZNC Bouncer: http://wiki.znc.in
 
* C++ Modules: http://wiki.znc.in/Writing_modules
 
* C++ Modules: http://wiki.znc.in/Writing_modules
 
* Module docs: http://people.znc.in/~psychon/znc/doc/classCModule.html
 
* Module docs: http://people.znc.in/~psychon/znc/doc/classCModule.html
 +
 +
 +
== Project Leaders ==
 +
* [[User:Rorist|Rorist]]
 +
* [[User:FreeStorm|FreeStorm]]
 +
 +
= Participants =

Latest revision as of 16:56, 14 November 2019


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

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


Project Leaders

Participants