Using commands

Commands

Commands are given to ZNC by messaging the virtual user *status. Likewise, modules are communicated to by messaging *modname as well.

Alternatively you can use /znc command instead of /msg *status command and /znc *module command instead of /msg *module command

Example: /msg *status listmods

<zncuser> listmods
<*status> +---------+------------------------------------------------------+
<*status> | Name    | Description                                          |
<*status> +---------+------------------------------------------------------+
<*status> | email   | Monitors Email activity on local disk /var/mail/user |
<*status> | shell   | Gives shell access.                                  |
<*status> | schat   | Secure cross platform (:P) chat system               |
<*status> +---------+------------------------------------------------------+

The prefix for these virtual users can be changed from * in the znc.conf file. It is wise to use a character that is illegal to use on IRC so that you don't lose the ability to talk to a real person who happens to be using the same prefix on their IRC nick.

Command List

<zncuser> help
<*status> In the following list all occurrences of <#chan> support wildcards (* and ?)
<*status> (Except ListNicks)
<*status> +------------------------+---------------------------------------+----------------------------------------------------------------------------------+
<*status> | Command                | Arguments                             | Description                                                                      |
<*status> +------------------------+---------------------------------------+----------------------------------------------------------------------------------+
<*status> | Version                |                                       | Print which version of ZNC this is                                               |
<*status> | ListMods               |                                       | List all loaded modules                                                          |
<*status> | ListAvailMods          |                                       | List all available modules                                                       |
<*status> | ListNicks              | <#chan>                               | List all nicks on a channel                                                      |
<*status> | ListServers            |                                       | List all servers of current IRC network                                          |
<*status> | AddNetwork             | <name>                                | Add a network to your user                                                       |
<*status> | DelNetwork             | <name>                                | Delete a network from your user                                                  |
<*status> | ListNetworks           |                                       | List all networks                                                                |
<*status> | MoveNetwork            | old-user old-net new-user [new-net]   | Move an IRC network from one user to another                                     |
<*status> | JumpNetwork            | <network>                             | Jump to another network (Alternatively, you can connect to ZNC several times,    |
          |                        |                                       | using `user/network` as username)                                                |
<*status> | AddServer              | <host> [[+]port] [pass]               | Add a server to the list of alternate/backup servers of current IRC network.     |
<*status> | DelServer              | <host> [port] [pass]                  | Remove a server from the list of alternate/backup servers of current IRC network |
<*status> | Enablechan             | <#chan>                               | Enable the channel                                                               |
<*status> | Disablechan            | <#chan>                               | Disable the channel                                                              |
<*status> | Detach                 | <#chan>                               | Detach from the channel                                                          |
<*status> | Topics                 |                                       | Show topics in all your channels                                                 |
<*status> | PlayBuffer              | <#chan>                               | Play back the buffer for a given channel                                          |
<*status> | ClearBuffer             | <#chan>                               | Clear the buffer for a given channel                                              |
<*status> | ClearAllChannelBuffers  |                                       | Clear the channel buffers                                                         |
<*status> | SetBuffer               | <#chan> [linecount]                   | Set the buffer count for a channel                                                |
<*status> | AddBindHost            | <host (IP preferred)>                 | Adds a bind host for normal users to use                                         |
<*status> | DelBindHost            | <host>                                | Removes a bind host from the list                                                |
<*status> | ListBindHosts          |                                       | Shows the configured list of bind hosts                                           |
<*status> | SetBindHost            | <host (IP preferred)>                 | Set the bind host for this connection                                            |
<*status> | SetUserBindHost        | <host (IP preferred)>                 | Set the default bind host for this user                                          |
<*status> | ClearBindHost          |                                       | Clear the bind host for this connection                                          |
<*status> | ClearUserBindHost      |                                       | Clear the default bind host for this user                                        |
<*status> | ShowBindHost           |                                       | Show currently selected bind host                                                |
<*status> | Jump [server]          |                                       | Jump to the next or the specified server                                          |
<*status> | Disconnect             | [message]                             | Disconnect from IRC                                                              |
<*status> | Connect                |                                       | Reconnect to IRC                                                                 |
<*status> | Uptime                 |                                       | Show for how long ZNC has been running                                           |
<*status> | LoadMod                | [--type=global|user|network] <module> | Load a module                                                                    |
<*status> | UnloadMod              | [--type=global|user|network] <module> | Unload a module                                                                  |
<*status> | ReloadMod              | [--type=global|user|network] <module> | Reload a module                                                                  |
<*status> | UpdateMod              | <module>                              | Reload a module everywhere                                                       |
<*status> | ShowMOTD               |                                       | Show ZNC's message of the day                                                    |
<*status> | SetMOTD                | <Message>                             | Set ZNC's message of the day                                                     |
<*status> | AddMOTD                | <Message>                             | Append <Message> to ZNC's MOTD                                                   |
<*status> | ClearMOTD              |                                       | Clear ZNC's MOTD                                                                 |
<*status> | ListPorts              |                                       | Show all active listeners                                                        |
<*status> | AddPort                | <arguments>                           | Add another port for ZNC to listen on                                            |
<*status> | DelPort                | <arguments>                           | Remove a port from ZNC                                                           |
<*status> | Rehash                 |                                       | Reload znc.conf from disk                                                        |
<*status> | SaveConfig              |                                       | Save the current settings to disk                                                |
<*status> | ListUsers              |                                       | List all ZNC users and their connection status                                   |
<*status> | ListAllUserNetworks    |                                       | List all ZNC users and their networks                                            |
<*status> | ListChans              | [User <network>]                      | List all channels                                                                |
<*status> | ListClients            | [User]                                | List all connected clients                                                       |
<*status> | Traffic                  |                                       | Show basic traffic stats for all ZNC users                                         |
<*status> | Broadcast              | [message]                             | Broadcast a message to all ZNC users                                             |
<*status> | Shutdown               | [message]                             | Shut down ZNC completely                                                         |
<*status> | Restart                | [message]                             | Restart ZNC                                                                      |
<*status> +------------------------+---------------------------------------+----------------------------------------------------------------------------------+