https://wiki.znc.in/api.php?action=feedcontributions&user=Dessa&feedformat=atomZNC - User contributions [en]2024-03-28T12:09:54ZUser contributionsMediaWiki 1.42.0-alphahttps://wiki.znc.in/index.php?title=MediaWiki:Sidebar&diff=2794MediaWiki:Sidebar2021-04-03T19:49:59Z<p>Dessa: switch to a simple link since the SidebarDonateBox extension broke</p>
<hr />
<div><br />
* navigation<br />
** mainpage|mainpage-description<br />
** FAQ|FAQ<br />
** Modules|Modules<br />
** recentchanges-url|recentchanges<br />
** randompage-url|randompage<br />
** helppage|help<br />
* SEARCH<br />
* TOOLBOX<br />
* LANGUAGES<br />
* donate<br />
** https://www.paypal.com/donate?hosted_button_id=X64ZH85FWE8SJ|PayPal</div>Dessahttps://wiki.znc.in/index.php?title=Template:ChangeLog&diff=2626Template:ChangeLog2019-09-27T22:43:50Z<p>Dessa: revert also change to https</p>
<hr />
<div><includeonly>{|style="width:100%; font-size:150%;"<br />
|style="text-align:left; width:33%;"| {{#invoke:ChangeLog|prev|this={{{this|{{SUBPAGENAME}}}}}|template=[[ChangeLog/XXX|← XXX]]}}<br />
|style="text-align:center; width:33%;"| ZNC {{{this|{{SUBPAGENAME}}}}}<br />
|style="text-align:right; width:33%;"| {{#invoke:ChangeLog|next|this={{{this|{{SUBPAGENAME}}}}}|template=[[ChangeLog/XXX|XXX →]]}}<br />
|}<br />
{{#switch: {{#invoke:ChangeLog|stability|this={{{this|{{SUBPAGENAME}}}}}}}<br />
| unstable = {{ambox<br />
| style = border-left: 10px solid #F28500; background: #FCE6CC;<br />
| image = [[File:Ambox orange.png|40px]]<br />
| text = This version is not released yet. Use at your own risk.<br />
{{#ifeq:{{#invoke:String|replace|{{ZNC-Version-Alpha}}|{{{this|{{SUBPAGENAME}}}}}|}}|{{ZNC-Version-Alpha}}||<br />
Source tarball of ZNC {{ZNC-Version-Alpha}} is available [https://znc.in/releases/archive/znc-{{ZNC-Version-Alpha}}.tar.gz here].}}<br />
}}<br />
| stable = {{ambox<br />
| style = border-left: 10px solid #4AA02C; background: #C3FDB8;<br />
| image = [[File:Ambox green.png|40px]]<br />
| text = This is the latest release. Source tarball is available [https://znc.in/releases/archive/znc-{{ZNC-Version}}.tar.gz here].<br />
}}<br />
| old = {{ambox<br />
| style = border-left: 10px solid #F28500; background: #FCE6CC;<br />
| image = [[File:Ambox orange.png|40px]]<br />
| text = This is an old ZNC version. If you still use it, please consider upgrading to [[ChangeLog/{{ZNC-Version}}|'''{{ZNC-Version}}''']].<br />
}}<br />
| Error: unknown version {{{this|{{SUBPAGENAME}}}}}, add it to [[Template:ZNC-Versions]]<br />
}}<br />
<br />
{{{category|[[<noinclude>:</noinclude>Category:ChangeLog]]}}}<br />
</includeonly><noinclude>Template for ChangeLog/XXX pages. E.g.: {{ChangeLog|this=1.6.1|category=}}</noinclude></div>Dessahttps://wiki.znc.in/index.php?title=ZNC&diff=2625ZNC2019-09-27T22:39:48Z<p>Dessa: Reverted edits by DarthGandalf (talk) to last revision by MetaNova</p>
<hr />
<div>__NOTOC__ {{Languages|ZNC}}<br />
<br />
Welcome to the '''ZNC wiki''' where you may find and publish information about '''ZNC''', an advanced [http://en.wikipedia.org/wiki/BNC_%28software%29#IRC 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.<br />
<br />
[[File:Overview_network_scheme.png|right]]<br />
[[File:Znc-0.99-black.png|right]]<br />
<br />
You can find us in [ircs://irc.freenode.net:6697/#znc #znc on freenode].<br />
<br />
== Download ZNC ==<br />
The latest stable release is '''{{ZNC-Version}}''' ([[ChangeLog/{{ZNC-Version}}|ChangeLog]]).<br />
You can find its source '''[https://znc.in/releases/znc-{{ZNC-Version}}.tar.gz <span style="color:#7F0000">here</span>]'''!<br />
<br />
Or you can try testing version, using [https://znc.in/nightly/?C=N&O=D nightly tarball] or [[Git]]{{#if:{{ZNC-Version-Alpha}}|, or '''[https://znc.in/releases/znc-{{ZNC-Version-Alpha}}.tar.gz <span style="color:#7F0000">ZNC {{ZNC-Version-Alpha}}</span>]'''|}}.<br />
<br />
Older versions can be found [https://znc.in/releases/ here].<br />
<br />
Several distros provide ZNC as a package, look at [[Installation]] page for details.<br />
<br />
== How does it work? ==<br />
* [[Installation|Install]] ZNC on your server.<br />
* Generate an initial configuration via <code>znc --makeconf</code>.<br />
** Each ZNC user can connect to several IRC networks, though you'll need to connect your IRC client to ZNC several times (once per network).<br />
** You can later change settings (add more users, tune existing ones, etc.) via the [[webadmin|web interface]] or from [[controlpanel|IRC]].<br />
* Configure your IRC client to connect to your ZNC server.<br />
** If your client has separate '''username''' and '''password''' fields, that works fine.<br />
*** You can set ''username'' as <code>username@clientid/network</code> to connect to a specific network. The network needs to be configured already. Without <code>/network</code> client will be connected to some random network.<br />
** If your client is broken and doesn't support specifying username in well... username, you can use <code>username@clientid/network:password</code> as the ''password''.<br />
** The ''@clientid'' is included with ZNC starting from '''1.6.0'''. This is optional and is the name that you give to your client to recognize it in <code>/msg *status listclients</code>. It's also used by some modules such as [[clientbuffer]] and [[chanfilter]].<br />
* Read the [[FAQ]] if you run into any problems. Feel free to ask on IRC if you need more help.<br />
* Enjoy! (Profit?)<br />
<br />
== Main Features ==<br />
[[Image:Webadmin-settings-dark-clouds.png|thumb|500px|Screenshot of the [[Webadmin]] module in action]]<br />
; [[Modules|Modules]] : ZNC supports dynamic loading of [[Writing modules|C++]], [[modperl|Perl]], [[modpython|Python]] and [[modtcl|Tcl]] modules. To get a list of the available modules and more information follow the link.<br />
; [[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.<br />
; Multiple Users : You can add additional users under one running process. Useful for public shells that limit background processes.<br />
; Multiple Networks : Each user can connect to several IRC networks at once, with an optional limit configured by ZNC admin.<br />
; [[Multiple clients|Multiple Clients]] : Connect to the same user/network with as many clients as you want.<br />
; 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.<br />
; SSL Support : Encryption for both the listen port and connecting to IRC servers. If your system has OpenSSL, ZNC automatically supports SSL connections.<br />
; IPv6 Support : Both IPv4 and IPv6 address families just work, if your system supports them.<br />
; 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.<br />
<br />
== Getting started ==<br />
* [[Introduction]]<br />
* [[Installation|Download and Installation]]<br />
* [[Connecting to ZNC]]<br />
* [[Using commands|Using ZNC]]<br />
* [[FAQ]]<br />
* [[Providers|Free ZNC providers (if you don't want or cannot install ZNC yourself)]]<br />
<br />
== Further Info ==<br />
* [[Identfile|Setting up ident spoofs via oidentd]]<br />
* [[Chroot]]<br />
* [[ZNC Backup]]<br />
* [[Running ZNC as a system daemon]]<br />
* [[Signed SSL certificate|Using signed SSL cert]]<br />
* [[History]]<br />
* [[Configuration|Configuration parameters]]<br />
* [[Tor|Using with Tor]]<br />
* [[Reverse proxy|Webadmin behind HTTP reverse proxy]]<br />
* [https://github.com/znc/znc/releases.atom Subscribe to new releases]<br />
<br />
=== Writing modules ===<br />
* [[Writing modules|Writing C++ modules]]<br />
* [[modperl|Writing Perl modules]]<br />
* [[modtcl|Writing Tcl modules]]<br />
* [[modpython|Writing Python modules]]<br />
* [[Debugging]]<br />
<br />
=== I want to help, what can I do? ===<br />
That's great! You can:<br />
* send pull requests on [https://github.com/znc/znc github]<br />
* [https://crowdin.com/project/znc-bouncer translate] ZNC to your language<br />
* improve documentation on this wiki<br />
* consult users on our IRC channel<br />
<br />
Talk to us if you have some other ideas.<br />
<br />
=== Internal docs ===<br />
* [[HowToRelease|How to release new ZNC version]]<br />
<br />
== External Links ==<br />
'''Please note that as of February 2011 we have abandoned SourceForge and moved to GitHub.'''<br />
* [https://github.com/znc/znc ZNC project page on GitHub] - report bugs/issues here<br />
* [http://freshmeat.net/projects/znc ZNC on FreshMeat]<br />
* [http://www.openhub.net/p/znc ZNC on OpenHUB]<br />
<br />
[[Category:ZNC]]</div>Dessahttps://wiki.znc.in/index.php?title=ZNC&diff=2549ZNC2019-03-30T17:26:10Z<p>Dessa: Reverted edits by DarthGandalf (talk) to last revision by MAGIC</p>
<hr />
<div>__NOTOC__ {{Languages|ZNC}}<br />
<br />
Welcome to the '''ZNC wiki''' where you may find and publish information about '''ZNC''', an advanced [http://en.wikipedia.org/wiki/BNC_%28software%29#IRC 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.<br />
<br />
[[File:Overview_network_scheme.png|right]]<br />
[[File:Znc-0.99-black.png|right]]<br />
<br />
You can find us in [ircs://irc.freenode.net:6697/#znc #znc on freenode].<br />
<br />
== Download ZNC ==<br />
The latest stable release is '''{{ZNC-Version}}''' ([[ChangeLog/{{ZNC-Version}}|ChangeLog]]).<br />
You can find its source '''[https://znc.in/releases/znc-{{ZNC-Version}}.tar.gz <span style="color:#7F0000">here</span>]'''!<br />
<br />
Or you can try testing version, using [https://znc.in/nightly/?C=N&O=D nightly tarball] or [[Git]]{{#if:{{ZNC-Version-Alpha}}|, or '''[https://znc.in/releases/znc-{{ZNC-Version-Alpha}}.tar.gz <span style="color:#7F0000">ZNC {{ZNC-Version-Alpha}}</span>]'''|}}.<br />
<br />
Older versions can be found [https://znc.in/releases/ here].<br />
<br />
Several distros provide ZNC as a package, look at [[Installation]] page for details.<br />
<br />
== How does it work? ==<br />
* [[Installation|Install]] ZNC on your server.<br />
* Generate an initial configuration via <code>znc --makeconf</code>.<br />
** Each ZNC user can connect to several IRC networks, though you'll need to connect your IRC client to ZNC several times (once per network).<br />
** You can later change settings (add more users, tune existing ones, etc.) via the [[webadmin|web interface]] or from [[controlpanel|IRC]].<br />
* Configure your IRC client to connect to your ZNC server.<br />
** If your client has separate '''username''' and '''password''' fields, that works fine.<br />
*** You can set ''username'' as <code>username@clientid/network</code> to connect to a specific network. The network needs to be configured already. Without <code>/network</code> client will be connected to some random network.<br />
** If your client is broken and doesn't support specifying username in well... username, you can use <code>username@clientid/network:password</code> as the ''password''.<br />
** The ''@clientid'' is included with ZNC starting from '''1.6.0'''. This is optional and is the name that you give to your client to recognize it in <code>/msg *status listclients</code>. It's also used by some modules such as [[chanfilter]].<br />
* Read the [[FAQ]] if you run into any problems. Feel free to ask on IRC if you need more help.<br />
* Enjoy! (Profit?)<br />
<br />
== Main Features ==<br />
[[Image:Webadmin-settings-dark-clouds.png|thumb|500px|Screenshot of the [[Webadmin]] module in action]]<br />
; [[Modules|Modules]] : ZNC supports dynamic loading of [[Writing modules|C++]], [[modperl|Perl]], [[modpython|Python]] and [[modtcl|Tcl]] modules. To get a list of the available modules and more information follow the link.<br />
; [[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.<br />
; Multiple Users : You can add additional users under one running process. Useful for public shells that limit background processes.<br />
; Multiple Networks : Each user can connect to several IRC networks at once, with an optional limit configured by ZNC admin.<br />
; [[Multiple clients|Multiple Clients]] : Connect to the same user/network with as many clients as you want.<br />
; 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.<br />
; SSL Support : Encryption for both the listen port and connecting to IRC servers. If your system has OpenSSL, ZNC automatically supports SSL connections.<br />
; IPv6 Support : Both IPv4 and IPv6 address families just work, if your system supports them.<br />
; 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.<br />
<br />
== Getting started ==<br />
* [[Introduction]]<br />
* [[Installation|Download and Installation]]<br />
* [[Connecting to ZNC]]<br />
* [[Using commands|Using ZNC]]<br />
* [[FAQ]]<br />
* [[Providers|Free ZNC providers (if you don't want or cannot install ZNC yourself)]]<br />
<br />
== Further Info ==<br />
* [[Identfile|Setting up ident spoofs via oidentd]]<br />
* [[Chroot]]<br />
* [[ZNC Backup]]<br />
* [[Running ZNC as a system daemon]]<br />
* [[Signed SSL certificate|Using signed SSL cert]]<br />
* [[History]]<br />
* [[Configuration|Configuration parameters]]<br />
* [[Tor|Using with Tor]]<br />
* [[Reverse proxy|Webadmin behind HTTP reverse proxy]]<br />
* [https://github.com/znc/znc/releases.atom Subscribe to new releases]<br />
<br />
=== Writing modules ===<br />
* [[Writing modules|Writing C++ modules]]<br />
* [[modperl|Writing Perl modules]]<br />
* [[modtcl|Writing Tcl modules]]<br />
* [[modpython|Writing Python modules]]<br />
* [[Debugging]]<br />
<br />
=== Internal docs ===<br />
* [[HowToRelease|How to release new ZNC version]]<br />
<br />
== External Links ==<br />
'''Please note that as of February 2011 we have abandoned SourceForge and moved to GitHub.'''<br />
* [https://github.com/znc/znc ZNC project page on GitHub] - report bugs/issues here<br />
* [http://freshmeat.net/projects/znc ZNC on FreshMeat]<br />
* [http://www.openhub.net/p/znc ZNC on OpenHUB]<br />
<br />
[[Category:ZNC]]</div>Dessahttps://wiki.znc.in/index.php?title=Modules&diff=2084Modules2017-04-11T08:35:59Z<p>Dessa: Reverted edits by 183.181.16.189 (talk) to last revision by 23.92.28.23</p>
<hr />
<div>{{Languages}}<br />
<br />
== Overview ==<br />
'''Modules''' are used to extend and modify the way ZNC functions. Users interact with modules most commonly by messaging a special user on IRC. For example, to view the highlight keywords in your watch list, you'd send ''/msg *watch list''. When ZNC sees that the nick you're messaging starts with an asterisk, it doesn't forward the message to the IRCd/server but instead sends it to the proper module for processing. In this case, the watch module will get the message and reply to you with a listing of your keywords. This makes for a very convenient and standard way of configuring or otherwise communicating with your loaded modules, as well as a common and standard way for your loaded modules to display status or other information. Notice that this is for loaded modules. You must load a given module, for example ''/znc loadmod watch'', before you can interface with the watch module. Most modules will reply to ''/msg *module help'' with a listing of available commands.<br />
<br />
ZNC modules are loaded either '''globally''', '''per-network''', or on a '''per-user''' basis. Each module defines for itself whether it is available to load as global, network-specific and/or user-specific. User level and network modules can do things ranging from [[crypt|manipulating the incoming/outgoing messages]] to [[twitter|implementing a full blown Twitter client]]. They can also do more traditional IRC tasks such as [[autoop|challenge based auto-op]], [[simple_away|setting you away]], or [[log|logging to disk]]. Each user gets to load and configure their own set of modules to customize their experience to suit their preference.<br />
<br />
Global modules are loadable by admins and provide functionality or change behavior for all users. For example, the [[partyline]] module has to be global since it provides functionality for all users on a given ZNC instance to be able to communicate with each other from within ZNC itself. Global modules can do everything that user-level modules can do, as well as a few extras. They can replace ZNC's [[imapauth|authentication system]], modify the config-writing process, deal with CAP, etc.<br />
<br />
The modules can also hook into ZNC's [[WebMods|web interface]] and provide web content. The most common web module is [[webadmin]] which allows admins to add/remove users and allows users to configure their settings from a browser.<br />
<br />
== Developers ==<br />
ZNC modules are written in C++ natively. There are also a couple of modules that embed an interpreter to allow you to load Perl, Python, or Tcl modules. To learn more about creation of modules you should read [[modperl|Perl Modules]], [[modpython|Python Modules]], [[modtcl|TCL Modules]], or [[Writing modules|C++ Modules]].<br />
<br />
Feel free to create wikipages about modules you have created, but don't forget to add a download link, contact information, and use the same layout as the rest of the modules. Contributions are always much appreciated.<br />
<br />
== Module List ==<br />
=== Global Modules ===<br />
; [[adminlog]] : Log user connects, disconnects, and failed logins to a file and/or to syslog.<br />
; [[blockuser]] : Blocks certain users from using ZNC, saying their account was disabled.<br />
; [[certauth]] : This module lets users to log in via SSL client keys.<br />
; [[cyrusauth]] : This module is intended for admins who run a shell/web/email/etc server and want to provide ZNC access to their existing users.<br />
; [[fail2ban]] : Block IPs for some time after a failed login.<br />
; [[identfile]] : Posts the ident of a user to a file when they are trying to connect.<br />
; [[imapauth]] : Allow users to authenticate via IMAP.<br />
; [[lastseen]] : Logs when a user last logged in to ZNC.<br />
; [[modperl]] : Loads Perl scripts as ZNC modules.<br />
; [[modpython]] : Allows you to use modules written on Python.<br />
; [[notify_connect]] : Sends a notice to all admins when a user logs in or out of ZNC.<br />
; [[partyline]] : Allows ZNC users to join internal channels and query other ZNC users on the same ZNC.<br />
; [[cyrusauth|saslauth]] : (Now [[cyrusauth]]) Allows users to authenticate via SASL.<br />
; [[webadmin]] : Allows you to add/remove/edit users and settings on the fly via a web browser.<br />
<br />
=== User Modules ===<br />
; [[controlpanel|admin]] : (Now [[controlpanel]]) Allows you to add/remove/edit users and settings on the fly via IRC messages.<br />
; [[autoattach]] : Watches your [[Detaching|detached]] channels and reattaches you automatically when there is specified activity in a channel you added to your autoattach list.<br />
; [[autoreply]] : Gives a automatic reply if someone messages you while you are away.<br />
; [[block_motd]] : Blocks the server's Message of the Day.<br />
; [[bouncedcc]] : Bounces DCC transfers through the znc server instead of sending them directly to the user.<br />
; [[buffextras]] : Add nick changes, joins, parts, topic changes etc. to your playback buffer.<br />
; [[chansaver]] : Saves channels to config when user joins and parts.<br />
; [[charset]] : Normalizes (i.e. converts) character encodings.<br />
; [[clearbufferonmsg]] : This module attempts to bridge the gap between being inundated with old buffer if you have KeepBuffer=true; and possibly missing messages when you ping out, if you have KeepBuffer=false.<br />
; [[clientnotify]] : Notify about new incoming connections to your user.<br />
; [[controlpanel]] : Allows you to add/remove/edit users and settings on the fly via IRC messages.<br />
; [[ctcpflood]] : This module tries to block CTCP floods.<br />
; [[dcc]] : This module allows you to transfer files to and from ZNC<br />
; [[disconkick]] : This module will kick your client from all channels if ZNC disconnects from server.<br />
; [[flooddetach]] : This module detaches you from channels which are flooded.<br />
; [[listsockets]] : This module displays a list of all open sockets in ZNC.<br />
; [[log]] : Log chat activity to file.<br />
; [[missingmotd]] : This user module will send 422 to clients when they login.<br />
; [[notes]] : Keep and replay notes. This is an example of [[WebMods]].<br />
; [[sample]] : This is an example module to help with [[writing modules]] to do whatever you want.<br />
; [[send_raw]] : Allows you to send raw traffic to IRC from other users.<br />
; [[shell]] : Access your Unix shell via query right inside of your IRC client.<br />
<br />
=== Network Modules ===<br />
; [[autocycle]] : Rejoin a channel when you are the only one there (to gain operator status).<br />
; [[autoop]] : Automatically give operator status to the good guys.<br />
; [[modtcl]] : Allows you to run Tcl scripts in ZNC.<br />
; [[autovoice]] : Automatically give voice status to everyone who joins some channel.<br />
; [[awaynick]] : Change your nick while you are away.<br />
; [[awaystore]] : When you are set away or detached, this module will save all private messages for you. The messages can be read until you delete them. This module will also set you away when you are idle some time.<br />
; [[cert]] : This module lets users use their own SSL certificate to connect to a server.<br />
; [[crypt]] : Encryption for channel/private messages.<br />
; [[keepnick]] : Tries to get and keep your primary nick if it is taken.<br />
; [[kickrejoin]] : Implements auto-rejoin-on-kick.<br />
; [[modules_online]] : Fakes online status of ZNC modules to fix some clients.<br />
; [[nickserv]] : Auths you with NickServ.<br />
; [[perform]] : Performs commands on connect.<br />
; [[q]] : Auths you with Q (and a little more).<br />
; [[raw]] : View all of the raw traffic.<br />
; [[route_replies]] : Routes back answers to the right client when connected with multiple clients.<br />
; [[sasl]] : Allows you to authenticate to an IRC network via SASL<br />
; [[savebuff]] : Saves your channel buffers into an encrypted file so they can survive restarts and reboots.<br />
; [[schat]] : SSL (encrypted) DCC chats.<br />
; [[simple_away]] : Automatically set you away on IRC when disconnected from the bouncer.<br />
; [[stickychan]] : Keeps you in specified channels.<br />
; [[watch]] : Monitor activity for specific text patterns from specific users and have the text sent to a special query window.<br />
<br />
=== More Modules ===<br />
For more modules, see [[:Category:Modules]].<br />
<br />
== Managing Modules ==<br />
Modules can be added or removed easily. Modules can be stored in <code>~/.znc/modules</code> and <code>/usr/local/lib/znc</code> by default. ZNC installs its modules to that second directory, which in fact is <code>${prefix}/lib/znc</code>, but this can be changed with <code>./configure --module-prefix=DIR</code> before compiling.<br />
<br />
ZNC will first look in the local sub-directory <code>modules</code> when searching for modules. Only files that end with ".so" will be seen as a module. To remove modules you can simply delete them from the folder. No other configuration changes or restarts are necessary. To remove, but also keep a module for later use you can also change the name, like: <code>mv sample.so sample.so_</code>.<br />
<br />
To compile a new module you must first save the source as a ".cpp" file. [[Compiling modules]] describes the process in detail.<br />
<br />
=== (Un)Loading Modules ===<br />
Global, user, and network modules can be (un)loaded from [[webadmin]] or via the <tt>*status</tt> query window, like:<br />
<br />
/msg *status LoadMod [--type=global|user|network] <module> <parameters><br />
/msg *status UnloadMod [--type=global|user|network] <module><br />
<br />
* <code>*</code> is the StatusPrefix set in your [[configuration]]. Usually it's just an asterisk ("*").<br />
* <code>[--type=global|user|network]</code> optionally specifies whether to (un)load the module as a global, user, or network module. Not all modules can be loaded at all levels; see individual [[:Category:Modules|Module documentation]] to find out where it may be loaded.<br />
* <code><module></code> is based on the modules file name, excluding the ".so" extension.<br />
* <code><parameters></code> are specific for each module and not required: You can provide parameters when loading the module, or you can set up the module after loading it.<br />
<br />
So, to load the '''[[log]]''' module at the '''global''' level (as opposed to user or network) and remove all color/formatting control codes with the '''<code>-sanitize</code>''' parameter, you would type:<br />
<br />
/msg *status LoadMod --type=global log -sanitize<br />
<br />
For older versions of ZNC, you won't have the option to specify <code>[--type=global|user|network]</code>. In that case, just use:<br />
/msg *status LoadMod <module> <parameters><br />
/msg *status UnloadMod <module><br />
<br />
Please keep in mind that a user is not able to load a module if the directive "DenyLoadMod" is set to true. Trying to load a module will fail with "Unable to load [<module>] Access Denied.".<br />
<br />
If a module prevents ZNC from starting up and therefore you can't unload the module using [[webadmin]], you can edit [[configuration|znc.conf]] and remove the corresponding <code>LoadModule</code> line.<br />
<br />
== Using modules ==<br />
It is recommended to read the module's wikipage if you want to find out how a module works. Alternatively the following command can be used to get a command list:<br />
/msg *<module> help<br />
* <code>*</code> is the StatusPrefix set in your [[configuration]]. Usually it's just an asterisk ("*").<br />
<br />
== External modules ==<br />
Below is a partial list of popular external modules. Please see [[:Category:External Modules]] for a comprehensive list.<br />
<br />
; [[amsgfilter]] : Filters amsgs from specified channels.<br />
; [[antiidle]] : Hides your idle time.<br />
; [[colloquy]] : Push private messages and highlights to your iPhone/iPod Touch via Colloquy Mobile.<br />
; [[email]] : Monitors email activity on local disk /var/mail/user.<br />
; [[fish]] : FiSH encryption for channel/private messages.<br />
; [[mutter]] : Push private messages and highlights to your mobile devices via Mutter IRC client for iOS.<br />
; [[push]] : Send private messages and highlights to your mobile devices using various push notification services. Includes a highly configurable set of conditions to control how and when notifications get sent.<br />
; [[twitter]] : Implements a Twitter client. It can post new tweets and monitor searches, users, timeline and @mentions.<br />
<br />
[[Category:Modules]]</div>Dessa