[[Category: Apps]]
tags: IRC Chat mIRC bounce Chatzilla server<br><br>
[http://www.amahi.org/apps/znc ZNC] is an Internet Relay Chat (IRC bounce with many advanced features such as a built-in web interface, persistent connection (detaching), multiple users, per channel playback buffer, SSL, IPv6, transparent DCC bouncingnetwork bouncer or BNC. It can detach the client from the actual IRC server, and c++ module support, also from selected channels. Multiple clients from different locations can connect to name a fewsingle ZNC account simultaneously and therefore appear under the same nickname on IRC. It supports Secure Sockets Layer (SSL) secured connections and IPv6.
== About ZNC in Amahi ==
* Currently '''BETA''' in for Amahi 7.
* The application makes use of your HDA first admin user. To log in to the web interface, enter that user name and the password is ''admin''. You can change the password once logged in to anything you desire.
* Once the application is installed, you are automatically connected to the IRC for the server '''irc.freenode.net'''. This setting can be turned off via the web interface if you do not want to autoconnect when ZNC is started.
* ZNC appears in the '''Servers''' tab so you can stop, start, and restart as needed.
* There is a [http://wiki.znc.in/FAQ FAQ] on the ZNC web site which may help with common questions.
== Initial Configuration ==
There are a few steps you need to complete before ZNC is ready.
# Log into the web interface using credentials as noted in the Special Instructions on the Applications Installed tab. Expand the ZNC app and you will see them displayed.
# Once logged in, select User Settings from the menu on the left.
# To be continued...
== IRC Client Setup ==
systemctl restart znc.service
* Access the web console via '''<nowiki>https://znc:26244</nowiki>'''
* All connections with IRC clients will be SSL. When you add new servers, ensure you precede the port number with a '''+'''. The default (the pre-installed server on install is already set for SSL communication).
<pre>40 0 * * 5 /var/hda/web-apps/znc/html/znc-backup.sh >/dev/null 2>&1</pre>
<blockquote><b>NOTE:</b> This will run on Fri at 00:40 AM, but you can change to meet your needs.</blockquote>
== IRC Client Setup ==
=== mIRC ===
*When using the mIRC client you will need to connect to ZNC using the following command:
<!--<nowiki>/server -m <yourHdaIp> -p 26244 -g gZNC -w <username>:<password> -d ZNC</nowiki>-->
/server -m <yourHdaIp> -p 26244 -g gZNC -w <username>:<password> -d ZNC
<table cellspacing="0" border="1">
<tr>
<th>Option</th>
<th>Description</th>
</tr>
<tr>
<td><yourHdaIp></td>
<td>The ip address of the HDA where you installed ZNC</td>
</tr>
<tr>
<td><username></td>
<td>Username that's configured to connect to a channel</td>
</tr>
<tr>
<td><password></td>
<td>Password for the username that's configured to connect to a channel</td>
</tr>
</table><br />
* When using mIRC in Windows, go to the options page. Select '''Server''' and choose '''Add'''. The following window will open:<br>
[[file:mirc-settings-znc.jpg]]<br />
<table cellspacing="0" border="1">
<tr>
<th>Option</th>
<th>Value</th>
</tr>
<tr>
<td>'''Description'''</td>
<td>ZNC</td>
</tr>
<tr>
<td>'''IRC Server'''</td>
<td>HDA IP</td>
</tr>
<tr>
<td>'''Port'''</td>
<td>26244</td>
</tr>
<tr>
<td>'''Group'''</td>
<td>ZNC</td>
</tr>
<tr>
<td>'''Password'''</td>
<td>ZNC <username>:<password></td>
</tr>
</table><br />
=== Chatzilla (FireFox Add-on) ===
After installation of Chatzilla Add-on you can enter the following in your browsers address bar:
irc://<YouHdaIp>:26244/<channel>/?pass=<ZncUser>:<ZncUserPass>
or
irc://<YourHdaIp>:26244/,needpass?pass=<ZncUser>:<ZncUserPass>
or SSL
ircs://<YourHdaIp>:26244/,needpass?pass=<ZncUser>:<ZncUserPass>
== Client 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''. <br />
{| style="color:black; background-color:#ffffcc;" cellpadding="1" cellspacing="0" border="1"
! '''Command'''
! '''Arguments'''
! '''Description'''
|+
|-
| Version
|
| Prints which version of znc this is
|-
| ListDCCs
|
| List all active DCCs
|-
| ListMods
|
| List all loaded modules
|-
| ListAvailMods
|
| List all available modules
|-
| ListChans
|
| List all channels
|-
| ListNicks
| <#chan>
| List all nicks on a channel
|-
| ListServers
|
| List all servers
|-
| AddServer
| <host> [[+]port] [pass]
| Add a server to the list
|-
| RemServer
| <host>
| Remove a server from the list
|-
| Enablechan
| <#chan>
| Enable the channel
|-
| Detach
| <#chan>
| Detach from the channel
|-
| Topics
|
| Show topics in all channels
|-
| PlayBuffer
| <#chan>
| Play back the buffer for a given channel
|-
| ClearBuffer
| <#chan>
| Clear the buffer for a given channel
|-
| ClearAllChannelBuffers
|
| Clear the channel buffers
|-
| SetBuffer
| <#chan> [linecount]
| Set the buffer count for a channel
|-
| SetVHost
| <vhost (ip preferred)>
| Set the VHost for this connection
|-
| ClearVHost
|
| Clear the VHost for this connection
|-
| Jump
|
| Jump to the next server in the list
|-
| Disconnect
|
| Disconnect from IRC
|-
| Connect
|
| Reconnect to IRC
|-
| Send
| <nick> <file>
| Send a shell file to a nick on IRC
|-
| Get
| <file>
| Send a shell file to yourself
|-
| LoadMod
| <module>
| Load a module
|-
| UnloadMod
| <module>
| Unload a module
|-
| ReloadMod
| <module>
| Reload a module
|-
| ShowMOTD
|
| Show the message of the day
|-
| SetMOTD
| <Message>
| Set the message of the day
|-
| AddMOTD
| <Message>
| Append <Message> to MOTD
|-
| ClearMOTD
|
| Clear the MOTD
|-
| Rehash
|
| Reload znc.conf from disk
|-
| SaveConfig
|
| Save the current settings to disk
|-
| ListUsers
|
| List all users/clients connected to znc
|-
| ListClients
| [User]
| List all clients connected to your znc user
|-
| Traffic
|
| Show basic traffic stats for all znc users
|-
| Uptime
|
| Show how long ZNC is already running
|-
| Broadcast
| [message]
| Broadcast a message to all users
|-
| Shutdown
| [message]
| Shutdown znc completely
|-
| Restart
| [message]
| Restarts znc
|}
'''NOTE:''' Go [http://en.znc.in/wiki/Modules here] for guidance on how to use ZNC modules.
== Troubleshooting ==
You could try using the IP address of the server you are trying to connect to. For '''''chat.freenode.net''''' this IP is:
'''''140.211.166.3'''''
* Go to your [http://znc:26244 ZNC webadmin page]
* Login using your username and password
* Click on "Your Settings"
* Once the RPMs have been removed, perform install.
* Check ''/var/log/amahi-app-installer.log'' for details.
<br>
[[Category: Apps]]
