IceChat Wiki - User contributions [en]

Main Page

2023-07-07T09:16:03Z

IceCold: update: the last version released.

IceChat 9 is the latest version of the IRC client which first came out in 2002. It is a complete re-write of the client using C#.Net. 
IceChat is user friendly, customizable and very stable IRC client. It runs on all Windows versions starting from Windows XP. 
On June 1st 2023, version 9.54 was the last version to be released. IceChat is no longer in active development.

== Features ==

Some of IceChat 9 main features are:
<ul>
<li>Flexible [[Layout|GUI]].</li>
<li>Independent [[plugins]] can be developed to expand the basic features.</li>
<li>Unicode support.</li>
<li>Built in SSL support and [[SASL|SASL]].</li>
<li>Customizable [[Settings#Emoticons_tab|Emoticons]]</li>
<li>Multiple servers support, keeping separate settings for each server.</li>
<li>Custom [[Popup Menus]] for different [[Layout|window types]]. </li>
<li>Customizable [[Colors#Themes tab|themes]]. </li>
</ul>

== Where to Start ==
=== IceChat 9 ===
There are several options to get the binaries for IceChat:
<dl>
<dt>Full Install</dt><dd>See details [[Install_IceChat_9 |here]]. </dd>
<dt>Portable version</dt><dd>See details on the [[Portable]] page.</dd>
<dt>Building from Source code</dt><dd>Code gets additions and fixes more often, so building from the source is useful. It is also very easy. The instructions are [[Build from source code | here]].</dd>
<dt>IceChat on Linux</dt><dd>IceChat 9 runs on Linux with some restrictions. See details [[IceChat_on_Linux|here]].</dd>
</dl>
 
Following are other pages that are useful to start with.

For adding servers, or understanding the numerous options available for servers, go to the [[New Server]] page.

Extensive information on IceChat GUI is found on the [[Layout]] page.

The [[Settings]] page explains the options available for IceChat.

In addition, the [[:Category:IceChat 9]] shows all the available pages for IceChat 9.

Information for advanced usage is listed in pages under the [[:Category:Advance Usage]] category.

The list of available categories is found [[:Special:Categories|here]].

=== IceChat 7 ===
IceChat 7 information is found [[IceChat 7|here]].

== Where to find us ==
<ul>
<li>[http://www.icechat.net/ IceChat web page]</li>
<li> [irc://irc.quakenet.org:6667/#icechat #icechat at irc.quakenet.org]</li>
<li>Visit our [http://www.icechat.net/forums/ forums]</li>
<li>Come to talk on our [https://www.facebook.com/IceChat facebook] page.</li>
<li>Follow us on [https://twitter.com/icechat/ twitter].</li>
<li>[https://en.wikipedia.org/wiki/IceChat Read about Icechat on Wikipedia]</li>
</ul>
== Who are we ==
IceChat was created by Snerf. He created the first version back in 2002, and kept renewing them ever since. 
You can find more info about the history of IceChat, with screenshots from earlier versions, on the [http://www.icechat.net/site/screenshots-history/ screenshots] page. The story of IceChat 9, also with some screenshots, is on the [http://www.icechat.net/site/icechat-9 IceChat 9] page, both on the main site.

This wiki was created and is maintained by IceCold.
== License ==

IceChat 9 is a free Open Source developed under the GPLv2 license.

[[Category:IceChat 9]]
[[Category:IceChat 7]]
[[Category:Initial]]
[[Category:General Info]]

New Server

2021-08-21T06:38:17Z

IceCold: added info to the BNC tab

== New Server/ Network ==
[[File:Ice9-add-new-server.jpg]] 

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

The Server Editor window is opened. 

[[File:Ice9-new-server.jpg]]

All the server's information is added or edited on this window.

The Main Settings tab includes the minimum set of options which are required for a functional server. These are described under the Required Settings heading. 
The additional set of options are described afterwards, in the following sections.

The main window's parts are described on the [[layout]] page. 

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
: Nick: IceChat9 
: Alt nick: IceChat9_ 
: Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
</dl>
<h3>Extra Settings tab</h3>
<dl>
<dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
</dl>
<h3>AutoJoin tab</h3>

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

[[File:Ice9-auto-join.jpg]]
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>
</dl>
<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>IRCv3 tab</h3>
[[File:Ice9-SASL-IRCv3.jpg]]

<dl>
<dt>Connect with [http://ircv3.net/irc/#sasl-authenticationlooks/ SASL]</dt>
<dd>If the server supports SASL, you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server.
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user go [[Settings#Away_tab| away] or come back.
</dd>
<dt>Account notify:</dt>
<dd> If enabled the user will be notified when other users login to accounts.</dd>
<dt>Change host</dt>
<dd>When enabled the client will be notified when usernames and/or hostnames are changed. This is relevant for users on the same channel(s) with you. This replaces the fake <code>/quit</code>, and the following fake <code>/join</code> messages instead.
</dd>
</dl>
<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
[[File:Ice9-bnc.jpg]]

Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Assuming you installed a BNC server locally with the following settings 
port: 65520 
username: snerf 
password: 123abc 

Add the BNC information for IceChat as follows: 
BNC server: 127.0.0.1 
BNC port:65520 
BNC username: snerf 
BNC password: 123abc 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

File:Ice9-bnc.jpg

2021-08-21T06:32:58Z

IceCold:

Portable

2021-08-14T04:23:18Z

IceCold: update the default profile location for portable, starting from ver 9.51

IceChat 9 can run as portable, without being installed.

The portable file is found on [http://www.icechat.net/site/downloads/download.php IceChat download page].

Extract the zip content into any subfolder which is not under <code>[https://en.wikipedia.org/wiki/Environment_variable#Default_values %ProgramFiles%]</code>. For example: c:\portable\IceChat.

Then, run the program.

By default the [[Data_Folder|profile]] is under the Settings folder where the zip was exrtacted.
If you wish to place the profile elsewhere, use the following command.

<code>icechat2009.exe -profile "C:\path\to\folder"</code>

As with the installed version there are two ways to initially run IceChat 9:
Import existing settings from IceChat 7 or starting with a clean setup.
See the details for each option [[Install_IceChat_9#First_Run|here]].

== Plugins and Emoticons ==

The common [[plugins]] and [[Settings#Emoticons_tab| emoticons]] that come with the installer, are not bundled with the portable version. They can be downloaded independently from the site's [http://www.icechat.net/site/downloads download] page.

Each of the packs need to be extracted and moved to its expected location:

The [[plugins]] should be placed in a Plugins subfolder under the program folder. For example: c:\portable\IceChat\Plugins.

The [[Settings#Emoticons_tab| emoticons]] should be placed in a Emoticons subfolder under the [[Data Folder]].

Example: 
Under Windows 7 (and later), for a user named Ice9, the default [[Data Folder]] location is <code>C:\Users\Ice9\AppData\Local\IceChat Networks\IceChat</code>.

For the above example, the extracted Emoticons folder should be moved to <code>C:\Users\Ice9\AppData\Local\IceChat Networks\IceChat\Emoticons</code>.

For more on possible locations and options for the [[Data Folder]], see the [[Multiple Instances]] page.

[[Category:IceChat 9]]
[[Category:Initial]]

Main Page

2021-06-19T13:26:52Z

IceCold: freenode IRC channel removed

IceChat 9 is the latest version of the IRC client which first came out in 2002. It is a complete re-write of the client using C#.Net. 
IceChat is user friendly, customizable and very stable IRC client. It runs on all Windows versions starting from Windows XP.

== Features ==

Some of IceChat 9 main features are:
<ul>
<li>Flexible [[Layout|GUI]].</li>
<li>Independent [[plugins]] can be developed to expand the basic features.</li>
<li>Unicode support.</li>
<li>Built in SSL support and [[SASL|SASL]].</li>
<li>Customizable [[Settings#Emoticons_tab|Emoticons]]</li>
<li>Multiple servers support, keeping separate settings for each server.</li>
<li>Custom [[Popup Menus]] for different [[Layout|window types]]. </li>
<li>Customizable [[Colors#Themes tab|themes]]. </li>
</ul>

== Where to Start ==
=== IceChat 9 ===
There are several options to get the binaries for IceChat:
<dl>
<dt>Full Install</dt><dd>See details [[Install_IceChat_9 |here]]. </dd>
<dt>Portable version</dt><dd>See details on the [[Portable]] page.</dd>
<dt>Building from Source code</dt><dd>Code gets additions and fixes more often, so building from the source is useful. It is also very easy. The instructions are [[Build from source code | here]].</dd>
<dt>IceChat on Linux</dt><dd>IceChat 9 runs on Linux with some restrictions. See details [[IceChat_on_Linux|here]].</dd>
</dl>
 
Following are other pages that are useful to start with.

For adding servers, or understanding the numerous options available for servers, go to the [[New Server]] page.

Extensive information on IceChat GUI is found on the [[Layout]] page.

The [[Settings]] page explains the options available for IceChat.

In addition, the [[:Category:IceChat 9]] shows all the available pages for IceChat 9.

Information for advanced usage is listed in pages under the [[:Category:Advance Usage]] category.

The list of available categories is found [[:Special:Categories|here]].

=== IceChat 7 ===
IceChat 7 information is found [[IceChat 7|here]].

== Where to find us ==
<ul>
<li>[http://www.icechat.net/ IceChat web page]</li>
<li> [irc://irc.quakenet.org:6667/#icechat #icechat at irc.quakenet.org]</li>
<li>Visit our [http://www.icechat.net/forums/ forums]</li>
<li>Come to talk on our [https://www.facebook.com/IceChat facebook] page.</li>
<li>Follow us on [https://twitter.com/icechat/ twitter].</li>
<li>[https://en.wikipedia.org/wiki/IceChat Read about Icechat on Wikipedia]</li>
</ul>
== Who are we ==
IceChat was created by Snerf. He created the first version back in 2002, and kept renewing them ever since. 
You can find more info about the history of IceChat, with screenshots from earlier versions, on the [http://www.icechat.net/site/screenshots-history/ screenshots] page. The story of IceChat 9, also with some screenshots, is on the [http://www.icechat.net/site/icechat-9 IceChat 9] page, both on the main site.

This wiki was created and is maintained by IceCold.
== License ==

IceChat 9 is a free Open Source developed under the GPLv2 license.

[[Category:IceChat 9]]
[[Category:IceChat 7]]
[[Category:Initial]]
[[Category:General Info]]

Main Page

2021-05-25T18:44:52Z

IceCold: Linked SASL feature to SASL page

IceChat 9 is the latest version of the IRC client which first came out in 2002. It is a complete re-write of the client using C#.Net. 
IceChat is user friendly, customizable and very stable IRC client. It runs on all Windows versions starting from Windows XP.

== Features ==

Some of IceChat 9 main features are:
<ul>
<li>Flexible [[Layout|GUI]].</li>
<li>Independent [[plugins]] can be developed to expand the basic features.</li>
<li>Unicode support.</li>
<li>Built in SSL support and [[SASL|SASL]].</li>
<li>Customizable [[Settings#Emoticons_tab|Emoticons]]</li>
<li>Multiple servers support, keeping separate settings for each server.</li>
<li>Custom [[Popup Menus]] for different [[Layout|window types]]. </li>
<li>Customizable [[Colors#Themes tab|themes]]. </li>
</ul>

== Where to Start ==
=== IceChat 9 ===
There are several options to get the binaries for IceChat:
<dl>
<dt>Full Install</dt><dd>See details [[Install_IceChat_9 |here]]. </dd>
<dt>Portable version</dt><dd>See details on the [[Portable]] page.</dd>
<dt>Building from Source code</dt><dd>Code gets additions and fixes more often, so building from the source is useful. It is also very easy. The instructions are [[Build from source code | here]].</dd>
<dt>IceChat on Linux</dt><dd>IceChat 9 runs on Linux with some restrictions. See details [[IceChat_on_Linux|here]].</dd>
</dl>
 
Following are other pages that are useful to start with.

For adding servers, or understanding the numerous options available for servers, go to the [[New Server]] page.

Extensive information on IceChat GUI is found on the [[Layout]] page.

The [[Settings]] page explains the options available for IceChat.

In addition, the [[:Category:IceChat 9]] shows all the available pages for IceChat 9.

Information for advanced usage is listed in pages under the [[:Category:Advance Usage]] category.

The list of available categories is found [[:Special:Categories|here]].

=== IceChat 7 ===
IceChat 7 information is found [[IceChat 7|here]].

== Where to find us ==
<ul>
<li>[http://www.icechat.net/ IceChat web page]</li>

<li>Our friendly IRC Channels:
<ol>
<li> [irc://irc.quakenet.org/#icechat #icechat at irc.quakenet.org] for general IceChat discussion</li>
<li> [irc://irc.freenode.net/#icechat #icechat at irc.freenode.net] for development discussion</li>
</ol>
</li>
<li>Visit our [http://www.icechat.net/forums/ forums]</li>
<li>Come to talk on our [https://www.facebook.com/IceChat facebook] page.</li>
<li>Follow us on [https://twitter.com/icechat/ twitter].</li>
<li>[https://en.wikipedia.org/wiki/IceChat Read about Icechat on Wikipedia]</li>
</ul>
== Who are we ==
IceChat was created by Snerf. He created the first version back in 2002, and kept renewing them ever since. 
You can find more info about the history of IceChat, with screenshots from earlier versions, on the [http://www.icechat.net/site/screenshots-history/ screenshots] page. The story of IceChat 9, also with some screenshots, is on the [http://www.icechat.net/site/icechat-9 IceChat 9] page, both on the main site.

This wiki was created and is maintained by IceCold.
== License ==

IceChat 9 is a free Open Source developed under the GPLv2 license.

[[Category:IceChat 9]]
[[Category:IceChat 7]]
[[Category:Initial]]
[[Category:General Info]]

SASL

2021-05-25T09:05:27Z

IceCold: SASL with pointer to new-server page SASL/IRCv3 tab

[https://ircv3.net/irc/#sasl-authenticationlooks/ SASL] (Simple Authentication and Security Layer) is an authentication mechanism across different IRC networks. It allows identification to services ([https://en.wikipedia.org/wiki/NickServ NickServ]) during the connection process, before anything else happens. As such, it eliminating the
need to <code>/msg NickServ identify</code>. 
To use SASL, you must first register your nickname (<code>/msg NickServ REGISTER YourPassword youremail@example.com</code>).

In IceChat 9 connection with SASL is part of the server editor. It is described on the [[New_Server#IRCv3_tab|SASL/ IRCv3 tab]].

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Settings]]
[[Category:Server]]

File:Ice9-SASL-IRCv3.jpg

2021-05-25T09:04:56Z

IceCold: IceCold uploaded a new version of File:Ice9-SASL-IRCv3.jpg

New Server

2021-05-25T08:18:06Z

IceCold: updated the IRCv3 screenshot to SASL/IRCv3

== New Server/ Network ==
[[File:Ice9-add-new-server.jpg]] 

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

The Server Editor window is opened. 

[[File:Ice9-new-server.jpg]]

All the server's information is added or edited on this window.

The Main Settings tab includes the minimum set of options which are required for a functional server. These are described under the Required Settings heading. 
The additional set of options are described afterwards, in the following sections.

The main window's parts are described on the [[layout]] page. 

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
: Nick: IceChat9 
: Alt nick: IceChat9_ 
: Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
</dl>
<h3>Extra Settings tab</h3>
<dl>
<dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
</dl>
<h3>AutoJoin tab</h3>

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

[[File:Ice9-auto-join.jpg]]
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>
</dl>
<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>IRCv3 tab</h3>
[[File:Ice9-SASL-IRCv3.jpg]]

<dl>
<dt>Connect with [http://ircv3.net/irc/#sasl-authenticationlooks/ SASL]</dt>
<dd>If the server supports SASL, you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server.
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user go [[Settings#Away_tab| away] or come back.
</dd>
<dt>Account notify:</dt>
<dd> If enabled the user will be notified when other users login to accounts.</dd>
<dt>Change host</dt>
<dd>When enabled the client will be notified when usernames and/or hostnames are changed. This is relevant for users on the same channel(s) with you. This replaces the fake <code>/quit</code>, and the following fake <code>/join</code> messages instead.
</dd>
</dl>
<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Add the BNC information: server address, port number. 
If the BNC requires username and password, add these as well. 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

File:Ice9-SASL-IRCv3.jpg

2021-05-25T08:16:20Z

IceCold:

Commands

2020-07-31T18:34:44Z

IceCold: added background command

IceChat 9 has a long list of commands that can be used in [[Popup Menus]], [[Aliases]] or the [[Layout#Default Layout | Input Line]].

The following conventions are used: 
<ul>
<li>Angle brackets <code>< ></code> represent a placeholder which should be replaced with actual values. </li>
<li>Square brackets <code>[ ]</code> represent optional parameters. </li>
<li>Pipe <code>|</code> represents a choice between several options for a single parameter. For example, <code>/topicbar <show | hide></code> means that the command can be used with <code>show</code> or <code>hide</code>. </li>
</ul>

== IRC related commands ==
This section includes commands that are either defined in the [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Technical_information IRC protocols] or were created in IceChat in order to make life easier for its users. Example, <code>/part</code> is an IRC command that leaves a specific channel. <code>/partall</code> extends that to leaving all the channels on a current server.

A complete list of IRC commands, with their syntax and description is found on [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands Wikipedia].

<dl>
<dt>/ame <text></dt><dd>Sends the text action to all channels you're currently on, on the current server.</dd>
<dt>/amsg <text></dt> <dd>Sends a message to all channels you're currently on, on the current server.</dd>
<dt>/anick <nickname></dt> <dd>Changes your current nickname to the specified nickname on all conected servers </dd>
<dt>/aquit, /quitall</dt> <dd>Disconnect all servers </dd>
<dt>/autojoin <#channel></dt> <dd>Automatically joins the specified channel, or toggles it, if already on the [[New_Server#Auto_Join_tab | AutoJoin]] list of the current [[New_Server#New_Server.2F_Network | Server]]. </dd>
<dt>/autoperform</dt> <dd>Runs the commands listed on the [[New_Server#AutoPerform_tab | AutoPerform tab]] of the [[New_Server#New_Server.2F_Network | Server Editor]] window on current server </dd>
<dt>/autostart</dt> <dd>Toggles the [[New_Server#Extra_Settings_tab|Connect on startup]] option for the current server. </dd>
<dt>/away</dt> <dd>Toggles your status between <code>away</code> and <code>not away</code>. Follows the options defined in the [[Settings#Away_tab | Away settings]]. </dd>
<dt>/aaway</dt> <dd>The above described <code>away</code> command is sent to all the connected servers. </dd>
<dt>/ban <#channel> <nickname | address><dt> or <dt>/mode <#channel> +b <nickname | address> </dt> <dd>A ban is a channel mode that is set to prevent clients with certain IRC identifiers (username, hostname, nickname) from joining that channel. Channel bans can only be set and removed by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. 
The ban is applied to the specified user/address for the specified channel. A ban can be removed with the <code>/mode <#channel> -b <nickname | address></code> command.</dd>
<dt>/forcequit</dt> <dd>Forces the current server to disconnect. </dd>
<dt>/hop</dt> <dd>Parts and re-joins the current channel. </dd>
<dt>/ignore <enable | disable></dt> <dd>Toggles the [[New_Server#Ignore_List_tab | Ignore List]] option for the current server.</dd>
<dt>/ignore -r <nickname></dt> <dd>Removes the <nickname> from the ignore list </dd>
<dt>/ignore -[p | n | c | i | t | d] <nickname></dt> <dd>Adds the specified nick name to the Ignore List. If the nick name is already on the list, it is un-checked. If none of the optional parameters is specified, then this <nickname> will be ignored on all types. The optional parameters stand for: p=private, n=notice, c=channel, i=invite, t=ctcp, d=dcc </dd>
<dt>/join <#channel></dt> <dd>Joins the specified channel. </dd>
<dt>/kick [#channel] <nickname> [reason]</dt> <dd>Kicks the specified user. If no channel is specieid, the current channel is assumed. If a reason was given, it is displayed. If no reason was provided, the nick of the user who kicked, is displayed. </dd>
<dt>/list </dt> <dd>Opens a Channel List window in which all the channels of the current server are listed. This list can be very long for the big networks. </dd>
<dt>/mode <nickname> <flags></dt> or <dt>/mode <#channel> <flags></dt> <dd>Sets the specified channel or nick name to the requested mode. Channel modes can be set only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. The supported modes depend on the specific network. Usually, the server's [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands#MOTD MOTD] lists the supported modes, or they can be found on the network documentation.</dd>
<dt>/modex</dt> <dd>Similar to /mode. Mostly, unsupported by networks. </dd>
<dt>/motd</dt> <dd>Displays the server's Message Of The Day on the console tab. </dd>
<dt>/names <#channel></dt> <dd>Displays a list of the users in the specified channel and their access levels (rank) on that channel. </dd>
<dt>/nick <nickname></dt> <dd>Changes the your current nick to the specified nick name. </dd>
<dt>/notice <nickname> <text></dt> <dd>Displays the specified text on the server's window of the specified user and on your current window. No automatic answer is returned. </dd>
<dt>/onotice [#channel] <message></dt> <dd>Sends the specified notice message to all channel ops. Not supported by all networks. </dd>
<dt>/part</dt> <dd>Parts from the current channel. </dd>
<dt>/partall</dt> <dd>Parts from all channels on current server </dd>
<dt>/ping <nickname></dt> <dd>Pings the specified nickname. </dd>
<dt>/query <nickname> <message></dt> <dd>Opens a private window for chat between you and the specified user. If the <nickname> is away and has an automatic away message, that message will be sent back. </dd>
<dt>/quit</dt> <dd>Disconnects the current server. </dd>
<dt>/spartall</dt> <dd>Parts all channels on all servers. </dd>
<dt>/topic [text]</dt> <dd>Displays the topic of the current channel. It any text is added to the command, the channel topic will be set to that text. Topic can be changed only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel's operators]. </dd>
<dt>/umode <flags></dt> <dd>Same as <code>/mode <myNickName> <flags></code>. See <code>/mode</code> above.</dd>
<dt>/version</dt> <dd>Returns the version of the current server. </dd>
<dt>/who <#channel></dt> <dd>Lists all the users on the specified channel. </dd>
<dt>/whois <nickname></dt> <dd>Returns info about the specified nick name. </dd>
</dl>

== Client features commands ==
This section includes commands that are specific to the client and were made to extend the user experience. for example, <code>/buddylist nickname</code> adds a specified nick to the buddy list. Alternately, this could have been achieved using the [[New_Server#Buddy_List_tab | GUI]] instead.

<dl>
<dt>/aline @<window name> <text></dt> <dd>Adds the specified text to the specified window. If the window does not exist, it will be opened. Example: <code>/aline @temp This is a test</code></dd>
<dt>/attach</dt> <dd>Re-attaches the current window back into the main program. (Counteracts the <code>/Detach</code> command.) </dd>
<dt>/bgcolor <color></dt> <dd>Changes the background color for the current window. The [[Colors#Colors_Palette | color]] parameter must be a number between 0 and 71. </dd>
<dt>/buddylist <nickname></dt> <dd>Adds the specified nickname to the buddy list. </dd>
<dt>/ctcp <nickname> <ping | finger | version | time | userinfo | clientinfo></dt> <dd>Performs the given ctcp request on the specified nickname. </dd>
<dt>/chaninfo [#channel]</dt> <dd>Opens a channel information window for the specified channel, or the current if no channel is specified. </dd>
<dt>/clear</dt> <dd>Clears the text of the current window. </dd>
<dt>/clearall</dt> <dd>Clears the text of all windows on all servers, including console. </dd>
<dt>/closeall</dt> <dd>Closes all the windows that were opened with <code>/window</code> or <code>/aline</code> commands. </dd>
<dt>/close</dt> <dd>Closes the current window </dd>
<dt>/closequery, /closeallquery</dt> <dd>Closes all your query windows on the current server.</dd>
<dt>/colormode [#channel]</dt> <dd>Toggles The No Color mode entry on the context menu of the specified channel. If no channel is specified, the current channel is assumed.</dd>
<dt>/cplay <#channel> <filename></dt> <dd>Similar to <code>/play</code> but checks if the sounds on the specified channels are muted. If they are, it won't play. </dd>
<dt>/detach</dt> <dd>Detaches the current window out of main program and onto its own. </dd>
<dt>/dcc chat <nickname></dt> <dd>Opens a dcc window and sends a dcc chat request to the specified user. </dd>
<dt>/dcc send <nickname> {file1} {file2} {file3} ... {fileN}</dt> <dd>Sends the specified files to the specified user. </dd>
<dt>/describe <#channel> <text></dt> <dd>Creates a self action with the specified text on the specified channel.(Similar to the <code>/me</code> command but for the specified channel.) </dd>
<dt>/debug</dt> <dd>Opens the debug window. </dd>
<dt>/export</dt> <dd>Exports the result of the <code>/list</code> command into a file. The user is prompted for the filename and location. The Channel List window must be the active window. </dd>
<dt>/font <#channel></dt> <dd>Opens the [[Settings#Fonts_tab|Fonts]] window for the user to choose a font. All text in the specified channel is changed to the selected font. The new setting is active only until the window is closed. </dd>
<dt>/flash <#channel> [off]</dt> <dd>Causes a specific channel to blink. <code>off</code> stops the blinking. </dd>
<dt>/flashtask, /flashtaskbar</dt> <dd>Causes the tasbkbar to blink </dd>
<dt>/flashtray <message></dt> <dd>Sends the specified message to the System Tray icon to show in a Balloon </dd>
<dt>/flashing</dt> <dd>This command toggles the flashing of the current channel on the Events->Flashing entry of the channel's context menu for the [[Layout#Default_Layout | channel bar]] and [[Layout#Default_Layout | server tree]]. </dd>
<dt>/icechat</dt> <dd>Returns the client name (IceChat), followed by the current version and build number. </dd>
<dt>/icepath</dt> <dd>Returns the path to the program. </dd>
<dt>/joinserv <irc.server.name> <#channel></dt> <dd>Connects to the specified server with [[New_Server#Default_Server_Settings |IceChat default nick name]] and joins the specified channel. </dd>
<dt>/logging</dt> <dd>Toggles the Disable Logging entry on the [https://en.wikipedia.org/wiki/Context_menu context menu] for the cureent channel. </dd>
<dt>/loadorder</dt> <dd>Loads a previously saved order of channel tabs on the tab bar. (See <code>/saveorder</code>)</dd>
<dt>/me <text></dt> <dd>Displays a self action with the specified text in the current channel. </dd>
<dt>/msg <nickname> <text></dt> <dd>Opens a window with a private message for the specified user under the current server. If the user is away and has set an automatic "away" answer, you'll get that answer. </dd>
<dt>/notify <nickname></dt> <dd>Adds the nickname to the buddy list. </dd>
<dt>/pin <#channel></dt> <dd>Iconifies the channel tab on the channel bar. </dd>
<dt>/play <filename></dt> <dd>Plays the <filename>. <filename> should include the full path, and it must be either a WAV or mp3 file. 
Example:
<code>/play d:\my music\Yellow Submarine.mp3</code> </dd>
<dt>/quote, /raw</dt> <dd>Sends raw server messages. 
Example:
<code>/quote whois Snerf</code></dd>
<dt>/run <program></dt> <dd>Runs a program. The full path and name must be provided. </dd>
<dt>/say <text></dt> <dd>Displays the specified text on the active window. </dd>
<dt>/saveorder</dt> <dd>Saves the current order of the channels on the tab bar to <code>ChannelSetting.xml</code> in the [[Data Folder]]. </dd>
<dt>/scid <serverID/NetworkName> </command> [parameters]</dt> <dd>Sends the specified command to the specified network or server number. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]] 
Example:
/scid quakenet /join #icechat</dd>
<dt>/server [-e] <server:[+]port> [port] [-i nick] [-j #channel password]</dt> or <dt>/server id=<serverId> </dt> <dd> This command connects to the specified server. 
If no port is specified, it'll use port 6667. 
<code>-e</code> parameter means to connect with SSL. Alternately, the + sign before the port number means to connect with SSL. In both cases, the SSL port must be provided, or the connection will fail. 
<code>-i</code> parameter followed by a nick, specify the requested nick. If no nick is provided, [[New_Server#Default_Server_Settings |IceChat default nick name]] will be used. 
<code>-j</code> parameter followed by a channel, specifiy the channel to join after the server is connected. 
serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]]. 
Examples: 
<code>/server irc.quakenet.org:6667 [-i IceChat9] [-j #IceChat]</code> 
<code>/server irc.freenode.net:+7000 [-i IceChat9] [-j #IceChat]</code>
</dd>
<dt>/sounds</dt> <dd>Toggles the sounds of the current channel on the Events->Sounds entry of the current channel's context menu. </dd>
<dt>/sound <#channel></dt> <dd>Toggles sounds for the specified channel on the context menu of that channel's Events->Sounds entry. </dd>
<dt>/switch #channel serverID</dt> <dd>Switches to the specified channel window under the specified server. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]].</dd>
<dt>/timers</dt> <dd>Displays all current timers on the current server. </dd>
<dt>/timer [-g]<n> <repetitions> <interval (in seconds)> <command></dt> <dd>This command allows delay before performing the specified command. 
<code>-g</code> is an optional parameter, which stands for global. Global timers can run without any server connected. 
<code>n</code> is a number required to identify the timer. 
<code>repetitions</code> is the number of times that the specified command will run. 
<code>interval</code> is the time gap between running the specified command. 
<code>command</code> is an IRC command to run.
</dd>
<dt>/topicbar <show | hide></dt> <dd>Displays or hides the [[Layout#Default_Layout | topic bar]]. </dd>
<dt>/totray</dt> <dd>Minimizes the client to the system tray. If you want to load IceChat directly into the system tray, add this command in the [[Settings#Startup tab | Settings' Startup tab]]. </dd>
<dt>/update</dt> <dd>Checks if a new version of IceChat is available. </dd>
<dt>/userinfo <nickname></dt> <dd>Opens a User info window with information about the specified nick name.</dd>
<dt>/window @<name></dt><dd>Opens a window with the specified name. Example: <code>/window @tests</code></dd>
<dt>/unpin <#channel></dt> <dd>Reverses the <code>/pin</code> command. The channel name is re-displayed on the channel bar. </dd>

<dt>/background console <image | none></dt> <dd>This command adds a background image to the console. Example: <code>/background console image.jpg</code>. To remove the background image: <code>/background console none</code>.
 
Note: The background image must be placed in the [[Data Folder]] under the Pictures sub folder.
</dd>

</dl>

== General features ==
This section includes commands that are not directly related to IRC or the client features. For example, opening the default browser or sending a Google search to the browser.

<dl>
<dt>/beep</dt> <dd>Sounds the Windows' beep.</dd>
<dt>/browser <url></dt> <dd>Opens the default browser with the specified url. /dd>
<dt>/dns <address></dt> <dd>Returns the IP of the address </dd>
<dt>/echo [text]</dt> <dd>Displays the text on current window </dd>
<dt>/google <text></dt> <dd>Opens default browser, and sends the specified text to Google search. </dd>

</dl>

__FORCETOC__

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

Build from source code

2020-07-30T07:34:08Z

IceCold: update starting from version 2.49: The main source and the plugins are built with .NET 4.5.2

IceChat 9 is an open source program, which means the source code is available to anyone.

The source code is updated more often then the full installs/updates and is located at https://github.com/icechat/IceChat

Download the latest source code from the page, by clicking on the Download Zip button.

Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the [https://en.wikipedia.org/wiki/Environment_variable#Default_values %CommonProgramFiles%], because of permissions possible limitations.

The source tree has several text files in its root folder, a build folder and a src, where the actual code and resources are located in several sub-folders. 

There are several build options in the extracted root folder.
<dl>
<dt>BuildIceChat.cmd</dt> <dd>which uses .NET 3.5, and should be used by XP users</dd>
<dt>BuildIceChat-x86.cmd</dt> <dd> which uses .NET 3.5 and a specific project for x86 computers. This too can be used by XP users.
</dd>
<dt>BuildIceChat.4.5.cmd </dt> <dd> which uses .NET 4.5.
</dd>
<dt>BuildIceChat.4.5-x86.cmd </dt> <dd>which uses .NET 4.5 and a specific project for x86 computers.
</dd>
<dt>BuildIceChat.latest.cmd </dt> <dd> which uses .NET 4.7.1
</dd>
<dt>BuildIceChatLinux.sh </dt> <dd>A script to build IceChat 9 under Linux. See [[IceChat on Linux]] for details.
</dd>
</dl>
If you are not sure which version to choose, and your OS is later then XP, use the BuildIceChat.4.5.cmd. 

Starting from version 2.49 The main source and the plugins are built with .NET 4.5.2, using Visual Studio 2017 

You can either double click on the BuildIceChat.4.5.cmd file or open a command line window (cmd.exe) and run the BuildIceChat.4.5.cmd at the prompt. 

You will get at the end of the process the following lines:
<pre>
0 Error(s)

Time Elapsed 00:00:00.32
..\src\IceChat\bin\Debug\IceChat2009.exe
1 File(s) copied
..\src\IceChat\\bin\Debug\IPluginIceChat.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IRCConnection.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IThemeIceChat.dll
1 File(s) copied
IceChat files copied to the IceChatBuild folder
Press any key to continue . . .
</pre>

A new folder is created called IceChatBuild, and once the batch file has completed, 4 files will be placed in this folder. 
A log file named <code>Manual_MSBuild_ReleaseVersion_LOG.log</code> is also created.

Copy these 4 files into your IceChat installation folder, or place them anywhere else you want.

To see all the changes from build to build, read the changelog.txt file in the root folder.
==Troubleshooting==

If the BuildIceChat.cmd returns errors, try instead to run the newer IceChatBuild.4.5.cmd which was specifically created for users who have errors with IceChatBuild.cmd.


If you experience problems connecting to servers with SSL, try build with IceChatBuild.4.5.cmd

==Sources==
Get Microsoft .NET Framework 4.5.2 at [https://www.microsoft.com/en-ca/download/details.aspx?id=42642 this] link.
[[Category:IceChat 9]]
[[Category:Initial]]
[[Category:Advance Usage]]
[[Category:Linux]]

Identifiers

2020-07-30T07:32:06Z

IceCold: Additional identifiers on build 9.49.05 May 31 2020

Identifiers are a set of reserved words that can be used in [[Aliases]], [[Popup Menus]], and directly as commands on the server or channel windows. They are always preceded by the $ symbol.


You can use the Identifiers on the servers and channels window by typing the following in the [[Layout#Default_Layout|input line]]: 
<code>//say <Identifier></code>

Example: 
<code>//say $version</code> 

Will return the program name and its currently installed version. At the time of writing, it returns: 
<code>IceChat 9.03</code>

== Server-related information ==
<dl>
<dt>$me</dt>
<dd>Displays the current [[New_Server#New_Server.2F_Network|NickName]] set for the current server. </dd>
 
<dt>$cme</dt>
<dd>Displays the [[New_Server#New_Server.2F_Network|NickName]]. </dd>
 
<dt>$altnick</dt>
<dd>Displays the current [[New_Server#Default_Settings|Alt NickName]] set for the current server. </dd>
 
<dt>$ident</dt>
<dd>Displays the [[New_Server#Default_Settings|Ident Name]] set for the current server. </dd>
 
<dt>$fullhost</dt>
<dd>Displays the current [[New_Server#New_Server.2F_Network|NickName]]. </dd>
 
<dt>$fullname</dt>
<dd>Displays the [[New_Server#New_Server.2F_Network|FullName]] set for the current server. </dd>
 
<dt>$network</dt>
<dd>The network to which your current server belongs. For example, irc.quakenet.org [https://www.quakenet.org/servers server list]. </dd>
 
<dt>$port</dt>
<dd>The port number through which you are connected to the current server. </dd>
 
<dt>$encoding</dt>
<dd>The [[New_Server#Extra_Settings_tab|encoding]] defined for the current server in the current server's settings. </dd>
 
<dt>$quitmessage</dt>
<dd>[[New_Server#Main_Settings_tab_2|quit Message]] defined for the current server. </dd>
 
<dt>$serverid</dt>
<dd>The ordinal number of the current server in the [[Layout#Server_Tree | Server Tree]]. In the provided link, the irc.freenode.net will get the number 2.</dd>
 
<dt>$server</dt>
<dd>The name of the currently connected server.</dd>
 
<dt>$serverip</dt>
<dd>The IP address of the currently connected server. </dd>
 
<dt>$randquit</dt>
<dd>The [[New_Server#Main_Settings_tab|quit message]] that was set for the current server. </dd>
 
<dt>$chanlogdir</dt>
<dd>The current-channel log folder. </dd>
 
<dt>$totallines</dt>
<dd>The number of text lines on the current window. </dd>
 
<dt>$ial(nickname).nick</dt>
<dt>$ial(nickname).host</dt>
<dd>ial stands for Internal Address List. The identifer provides the requested detail for the specified nickname.If no detail is specified, <code>$ial(nickname)</code> provides its nick. 
Example: <code>$ial($me).host</code> returns IceChat.users.quakenet.org
</dd>

</dl>
== IceChat Setting information ==
<dl>
<dt>$theme</dt>
<dd>The currently used IceChat [[Colors|Theme]]. </dd>
 
<dt>$icechatver</dt>
<dd>The currently installed version. </dd>
 
<dt>$version</dt>
<dd>The client name (IceChat) followed by the currently installed version. </dd>
 
<dt>$icechat</dt>
<dd>The client name (IceChat), followed by the currently installed version, followed by IceChat [http://www.icechat.net web site address]. </dd>
 
<dt>$icepath, $icechatexedir</dt>
<dd>The directory where IceChat 9 is installed. </dd>
 
<dt>$plugindir</dt>
<dd>The directory where IceChat 9 [[plugins]] are located. </dd>
 
<dt>$icechatdir</dt>
<dd>The location of the [[Profiles#Data_Folder|Data Folder]]. </dd>
 
<dt>$randcolor</dt>
<dd>A random number between 0 and 71. This number represents an ordinal number of a random [[colors|color]] on the Colors palette. </dd>
 
<dt>$totalplugins</dt>
<dd>Displays the number of loaded [[plugins]]. </dd>
 
<dt>$plugins</dt>
<dd>Lists the currently loaded [[plugins]]. </dd>
 
<dt>$plugin(id).name</dt>
<dt>$plugin(id).version</dt>
<dt>$plugin(id).author</dt>
<dt>$plugin(id).enabled</dt>
<dt>$plugin(id).filename</dt>
<dd>ID is an ordinal number starting from 0 (zero) up to <code>$totalplugins</code> - 1. This identifer works on loaded [[plugins]] and provides the requested detail. If no detail is specified, <code>$plugin(id)</code> provides its name. 
Example: <code>$plugin(0).name</code> returns HighLite Plugin</dd>

</dl>
== IceChat External information ==
<dl>
<dt>$colors</dt>
<dd>The filename of the currently used [[Colors|Theme]]. </dd>
 
<dt>$aliasfile</dt>
<dd>The location and name of the [[aliases]] file. The file is located in the [[Profiles#Data_Folder|Data Folder]] </dd>
 
<dt>$serverfile</dt>
<dd>The location and name of the [[Data Folder#XML files|server file]]. The file is located in the [[Profiles#Data_Folder|Data Folder]]. </dd>
 
<dt>$popupfile</dt>
<dd>The location and name of the [[Popup Menus]] file. The file is located in the [[Profiles#Data_Folder|Data Folder]]. </dd>
 
<dt>$logdir</dt>
<dd>The location of the log file. The file is located in a sub-folder under the [[Profiles#Data_Folder|Data Folder]]. </dd>

</dl>

== Environment information ==
<dl>
<dt>$ip</dt>
<dd>Your system's [http://www.computerhope.com/jargon/e/externip.htm external IP address]</dd>
 
<dt>$localip</dt>
<dd>Same as $ip. </dd>
 
<dt>$online</dt>
<dd>The online time since the last boot.</dd>
 
<dt>$appdata</dt>
<dd>The Windows current-user's [https://en.wikipedia.org/wiki/Environment_variable#Default_values %LOCALAPPDATA%] folder. </dd>
 
<dt>$os</dt>
<dd>The operating system's name. </dd>
 
<dt>$ossp</dt>
<dd>Windows servise pack. </dd>
 
<dt>$osbuild</dt>
<dd>Windows build number. </dd>
 
<dt>$osplatform</dt>
<dd>Platform information for the operating system. 
NOTE: Win32NT is returned for both 32bit and 64bit. </dd>
 
<dt>$osbits</dt>
<dd>The processor architecture, 32 or 64 bit. </dd>
 
<dt>$time</dt>
<dd>The system's local time. </dd>
 
<dt>$date</dt>
<dd>The system's local date. </dd>
 
<dt>$icechathandle</dt>
<dd>The [https://en.wikipedia.org/wiki/Handle_%28computing%29#Examples window handle] of IceChat current instance. </dd>
 
<dt>$tickcount, $ticks</dt>
<dd>The number of milliseconds elapsed since the system started. </dd>
 
<dt>$totalwindows</dt>
<dd>The number of open tabs. </dd>
 
<dt>$totalscreens</dt>
<dd>The number of screens connected to this operating system. </dd>
 
<dt>$currentwindow, $active</dt>
<dd>The currently active tab. </dd>
 
<dt>$framework</dt>
<dd>The .NET major, minor, build, and revision numbers. </dd>
 
<dt>$uptime2</dt>
<dd>The number of miliseconds since the last boot converted into a human readable format. </dd>
 
<dt>$uptime</dt>
<dd>Similar to $uptime2 from another system resource. </dd>
 

<dt>$ram</dt>
<dd>Shows the total amount of the system's [https://en.wikipedia.org/wiki/Random-access_memory RAM]. </dd>
 

<dt>$cpu</dt>
<dd>Displays the [https://en.wikipedia.org/wiki/Central_processing_unit CPU] brand. </dd>
 

<dt>$gpu</dt>
<dd>Displays the system's [https://en.wikipedia.org/wiki/Graphics_processing_unit gpu] brand. </dd>
 

</dl>
== General Purpose ==

<dl>
<dt>$read(filename)</dt>
<dd>Reads a random line from the specified file. If no specific path is provided, defaults to read the file in the Scripts folder under [[Data Folder]]. </dd>

 
<dt>$md5<filename></dt>
<dd>Returns the [https://en.wikipedia.org/wiki/MD5 MD5] of the specified file. </dd>

 
<dt>$rand<min,max></dt>
<dd>Returns a random number between the specified munimum and maximum </dd>
 
<dt>$timer(id).id</dt>
<dt>$timer(id).reps</dt>
<dt>$timer(id).count</dt>
<dt>$timer(id).command</dt>
<dt>$timer(id).interval</dt>
<dd>ID is an ordinal number starting from 1 up to the number of timers defined for the current server. 
The identifer provides the requested detail for the specified timer.If no detail is specified, <code>$timer(id)</code> provides its id.</dd>

</dl>

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

File:Ice9-colors-98.jpg

2019-09-14T21:24:50Z

IceCold:

Commands

2018-09-29T20:35:48Z

IceCold: add -r to /ignore command in version 9.21b

IceChat 9 has a long list of commands that can be used in [[Popup Menus]], [[Aliases]] or the [[Layout#Default Layout | Input Line]].

The following conventions are used: 
<ul>
<li>Angle brackets <code>< ></code> represent a placeholder which should be replaced with actual values. </li>
<li>Square brackets <code>[ ]</code> represent optional parameters. </li>
<li>Pipe <code>|</code> represents a choice between several options for a single parameter. For example, <code>/topicbar <show | hide></code> means that the command can be used with <code>show</code> or <code>hide</code>. </li>
</ul>

== IRC related commands ==
This section includes commands that are either defined in the [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Technical_information IRC protocols] or were created in IceChat in order to make life easier for its users. Example, <code>/part</code> is an IRC command that leaves a specific channel. <code>/partall</code> extends that to leaving all the channels on a current server.

A complete list of IRC commands, with their syntax and description is found on [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands Wikipedia].

<dl>
<dt>/ame <text></dt><dd>Sends the text action to all channels you're currently on, on the current server.</dd>
<dt>/amsg <text></dt> <dd>Sends a message to all channels you're currently on, on the current server.</dd>
<dt>/anick <nickname></dt> <dd>Changes your current nickname to the specified nickname on all conected servers </dd>
<dt>/aquit, /quitall</dt> <dd>Disconnect all servers </dd>
<dt>/autojoin <#channel></dt> <dd>Automatically joins the specified channel, or toggles it, if already on the [[New_Server#Auto_Join_tab | AutoJoin]] list of the current [[New_Server#New_Server.2F_Network | Server]]. </dd>
<dt>/autoperform</dt> <dd>Runs the commands listed on the [[New_Server#AutoPerform_tab | AutoPerform tab]] of the [[New_Server#New_Server.2F_Network | Server Editor]] window on current server </dd>
<dt>/autostart</dt> <dd>Toggles the [[New_Server#Extra_Settings_tab|Connect on startup]] option for the current server. </dd>
<dt>/away</dt> <dd>Toggles your status between <code>away</code> and <code>not away</code>. Follows the options defined in the [[Settings#Away_tab | Away settings]]. </dd>
<dt>/aaway</dt> <dd>The above described <code>away</code> command is sent to all the connected servers. </dd>
<dt>/ban <#channel> <nickname | address><dt> or <dt>/mode <#channel> +b <nickname | address> </dt> <dd>A ban is a channel mode that is set to prevent clients with certain IRC identifiers (username, hostname, nickname) from joining that channel. Channel bans can only be set and removed by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. 
The ban is applied to the specified user/address for the specified channel. A ban can be removed with the <code>/mode <#channel> -b <nickname | address></code> command.</dd>
<dt>/forcequit</dt> <dd>Forces the current server to disconnect. </dd>
<dt>/hop</dt> <dd>Parts and re-joins the current channel. </dd>
<dt>/ignore <enable | disable></dt> <dd>Toggles the [[New_Server#Ignore_List_tab | Ignore List]] option for the current server.</dd>
<dt>/ignore -r <nickname></dt> <dd>Removes the <nickname> from the ignore list </dd>
<dt>/ignore -[p | n | c | i | t | d] <nickname></dt> <dd>Adds the specified nick name to the Ignore List. If the nick name is already on the list, it is un-checked. If none of the optional parameters is specified, then this <nickname> will be ignored on all types. The optional parameters stand for: p=private, n=notice, c=channel, i=invite, t=ctcp, d=dcc </dd>
<dt>/join <#channel></dt> <dd>Joins the specified channel. </dd>
<dt>/kick [#channel] <nickname> [reason]</dt> <dd>Kicks the specified user. If no channel is specieid, the current channel is assumed. If a reason was given, it is displayed. If no reason was provided, the nick of the user who kicked, is displayed. </dd>
<dt>/list </dt> <dd>Opens a Channel List window in which all the channels of the current server are listed. This list can be very long for the big networks. </dd>
<dt>/mode <nickname> <flags></dt> or <dt>/mode <#channel> <flags></dt> <dd>Sets the specified channel or nick name to the requested mode. Channel modes can be set only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. The supported modes depend on the specific network. Usually, the server's [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands#MOTD MOTD] lists the supported modes, or they can be found on the network documentation.</dd>
<dt>/modex</dt> <dd>Similar to /mode. Mostly, unsupported by networks. </dd>
<dt>/motd</dt> <dd>Displays the server's Message Of The Day on the console tab. </dd>
<dt>/names <#channel></dt> <dd>Displays a list of the users in the specified channel and their access levels (rank) on that channel. </dd>
<dt>/nick <nickname></dt> <dd>Changes the your current nick to the specified nick name. </dd>
<dt>/notice <nickname> <text></dt> <dd>Displays the specified text on the server's window of the specified user and on your current window. No automatic answer is returned. </dd>
<dt>/onotice [#channel] <message></dt> <dd>Sends the specified notice message to all channel ops. Not supported by all networks. </dd>
<dt>/part</dt> <dd>Parts from the current channel. </dd>
<dt>/partall</dt> <dd>Parts from all channels on current server </dd>
<dt>/ping <nickname></dt> <dd>Pings the specified nickname. </dd>
<dt>/query <nickname> <message></dt> <dd>Opens a private window for chat between you and the specified user. If the <nickname> is away and has an automatic away message, that message will be sent back. </dd>
<dt>/quit</dt> <dd>Disconnects the current server. </dd>
<dt>/spartall</dt> <dd>Parts all channels on all servers. </dd>
<dt>/topic [text]</dt> <dd>Displays the topic of the current channel. It any text is added to the command, the channel topic will be set to that text. Topic can be changed only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel's operators]. </dd>
<dt>/umode <flags></dt> <dd>Same as <code>/mode <myNickName> <flags></code>. See <code>/mode</code> above.</dd>
<dt>/version</dt> <dd>Returns the version of the current server. </dd>
<dt>/who <#channel></dt> <dd>Lists all the users on the specified channel. </dd>
<dt>/whois <nickname></dt> <dd>Returns info about the specified nick name. </dd>
</dl>

== Client features commands ==
This section includes commands that are specific to the client and were made to extend the user experience. for example, <code>/buddylist nickname</code> adds a specified nick to the buddy list. Alternately, this could have been achieved using the [[New_Server#Buddy_List_tab | GUI]] instead.

<dl>
<dt>/aline @<window name> <text></dt> <dd>Adds the specified text to the specified window. If the window does not exist, it will be opened. Example: <code>/aline @temp This is a test</code></dd>
<dt>/attach</dt> <dd>Re-attaches the current window back into the main program. (Counteracts the <code>/Detach</code> command.) </dd>
<dt>/bgcolor <color></dt> <dd>Changes the background color for the current window. The [[Colors#Colors_Palette | color]] parameter must be a number between 0 and 71. </dd>
<dt>/buddylist <nickname></dt> <dd>Adds the specified nickname to the buddy list. </dd>
<dt>/ctcp <nickname> <ping | finger | version | time | userinfo | clientinfo></dt> <dd>Performs the given ctcp request on the specified nickname. </dd>
<dt>/chaninfo [#channel]</dt> <dd>Opens a channel information window for the specified channel, or the current if no channel is specified. </dd>
<dt>/clear</dt> <dd>Clears the text of the current window. </dd>
<dt>/clearall</dt> <dd>Clears the text of all windows on all servers, including console. </dd>
<dt>/closeall</dt> <dd>Closes all the windows that were opened with <code>/window</code> or <code>/aline</code> commands. </dd>
<dt>/close</dt> <dd>Closes the current window </dd>
<dt>/closequery, /closeallquery</dt> <dd>Closes all your query windows on the current server.</dd>
<dt>/colormode [#channel]</dt> <dd>Toggles The No Color mode entry on the context menu of the specified channel. If no channel is specified, the current channel is assumed.</dd>
<dt>/cplay <#channel> <filename></dt> <dd>Similar to <code>/play</code> but checks if the sounds on the specified channels are muted. If they are, it won't play. </dd>
<dt>/detach</dt> <dd>Detaches the current window out of main program and onto its own. </dd>
<dt>/dcc chat <nickname></dt> <dd>Opens a dcc window and sends a dcc chat request to the specified user. </dd>
<dt>/dcc send <nickname> {file1} {file2} {file3} ... {fileN}</dt> <dd>Sends the specified files to the specified user. </dd>
<dt>/describe <#channel> <text></dt> <dd>Creates a self action with the specified text on the specified channel.(Similar to the <code>/me</code> command but for the specified channel.) </dd>
<dt>/debug</dt> <dd>Opens the debug window. </dd>
<dt>/export</dt> <dd>Exports the result of the <code>/list</code> command into a file. The user is prompted for the filename and location. The Channel List window must be the active window. </dd>
<dt>/font <#channel></dt> <dd>Opens the [[Settings#Fonts_tab|Fonts]] window for the user to choose a font. All text in the specified channel is changed to the selected font. The new setting is active only until the window is closed. </dd>
<dt>/flash <#channel> [off]</dt> <dd>Causes a specific channel to blink. <code>off</code> stops the blinking. </dd>
<dt>/flashtask, /flashtaskbar</dt> <dd>Causes the tasbkbar to blink </dd>
<dt>/flashtray <message></dt> <dd>Sends the specified message to the System Tray icon to show in a Balloon </dd>
<dt>/flashing</dt> <dd>This command toggles the flashing of the current channel on the Events->Flashing entry of the channel's context menu for the [[Layout#Default_Layout | channel bar]] and [[Layout#Default_Layout | server tree]]. </dd>
<dt>/icechat</dt> <dd>Returns the client name (IceChat), followed by the current version and build number. </dd>
<dt>/icepath</dt> <dd>Returns the path to the program. </dd>
<dt>/joinserv <irc.server.name> <#channel></dt> <dd>Connects to the specified server with [[New_Server#Default_Server_Settings |IceChat default nick name]] and joins the specified channel. </dd>
<dt>/logging</dt> <dd>Toggles the Disable Logging entry on the [https://en.wikipedia.org/wiki/Context_menu context menu] for the cureent channel. </dd>
<dt>/loadorder</dt> <dd>Loads a previously saved order of channel tabs on the tab bar. (See <code>/saveorder</code>)</dd>
<dt>/me <text></dt> <dd>Displays a self action with the specified text in the current channel. </dd>
<dt>/msg <nickname> <text></dt> <dd>Opens a window with a private message for the specified user under the current server. If the user is away and has set an automatic "away" answer, you'll get that answer. </dd>
<dt>/notify <nickname></dt> <dd>Adds the nickname to the buddy list. </dd>
<dt>/pin <#channel></dt> <dd>Iconifies the channel tab on the channel bar. </dd>
<dt>/play <filename></dt> <dd>Plays the <filename>. <filename> should include the full path, and it must be either a WAV or mp3 file. 
Example:
<code>/play d:\my music\Yellow Submarine.mp3</code> </dd>
<dt>/quote, /raw</dt> <dd>Sends raw server messages. 
Example:
<code>/quote whois Snerf</code></dd>
<dt>/run <program></dt> <dd>Runs a program. The full path and name must be provided. </dd>
<dt>/say <text></dt> <dd>Displays the specified text on the active window. </dd>
<dt>/saveorder</dt> <dd>Saves the current order of the channels on the tab bar to <code>ChannelSetting.xml</code> in the [[Data Folder]]. </dd>
<dt>/scid <serverID/NetworkName> </command> [parameters]</dt> <dd>Sends the specified command to the specified network or server number. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]] 
Example:
/scid quakenet /join #icechat</dd>
<dt>/server [-e] <server:[+]port> [port] [-i nick] [-j #channel password]</dt> or <dt>/server id=<serverId> </dt> <dd> This command connects to the specified server. 
If no port is specified, it'll use port 6667. 
<code>-e</code> parameter means to connect with SSL. Alternately, the + sign before the port number means to connect with SSL. In both cases, the SSL port must be provided, or the connection will fail. 
<code>-i</code> parameter followed by a nick, specify the requested nick. If no nick is provided, [[New_Server#Default_Server_Settings |IceChat default nick name]] will be used. 
<code>-j</code> parameter followed by a channel, specifiy the channel to join after the server is connected. 
serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]]. 
Examples: 
<code>/server irc.quakenet.org:6667 [-i IceChat9] [-j #IceChat]</code> 
<code>/server irc.freenode.net:+7000 [-i IceChat9] [-j #IceChat]</code>
</dd>
<dt>/sounds</dt> <dd>Toggles the sounds of the current channel on the Events->Sounds entry of the current channel's context menu. </dd>
<dt>/sound <#channel></dt> <dd>Toggles sounds for the specified channel on the context menu of that channel's Events->Sounds entry. </dd>
<dt>/switch #channel serverID</dt> <dd>Switches to the specified channel window under the specified server. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]].</dd>
<dt>/timers</dt> <dd>Displays all current timers on the current server. </dd>
<dt>/timer [-g]<n> <repetitions> <interval (in seconds)> <command></dt> <dd>This command allows delay before performing the specified command. 
<code>-g</code> is an optional parameter, which stands for global. Global timers can run without any server connected. 
<code>n</code> is a number required to identify the timer. 
<code>repetitions</code> is the number of times that the specified command will run. 
<code>interval</code> is the time gap between running the specified command. 
<code>command</code> is an IRC command to run.
</dd>
<dt>/topicbar <show | hide></dt> <dd>Displays or hides the [[Layout#Default_Layout | topic bar]]. </dd>
<dt>/totray</dt> <dd>Minimizes the client to the system tray. If you want to load IceChat directly into the system tray, add this command in the [[Settings#Startup tab | Settings' Startup tab]]. </dd>
<dt>/update</dt> <dd>Checks if a new version of IceChat is available. </dd>
<dt>/userinfo <nickname></dt> <dd>Opens a User info window with information about the specified nick name.</dd>
<dt>/window @<name></dt><dd>Opens a window with the specified name. Example: <code>/window @tests</code></dd>
<dt>/unpin <#channel></dt> <dd>Reverses the <code>/pin</code> command. The channel name is re-displayed on the channel bar. </dd>
</dl>

== General features ==
This section includes commands that are not directly related to IRC or the client features. For example, opening the default browser or sending a Google search to the browser.

<dl>
<dt>/beep</dt> <dd>Sounds the Windows' beep.</dd>
<dt>/browser <url></dt> <dd>Opens the default browser with the specified url. /dd>
<dt>/dns <address></dt> <dd>Returns the IP of the address </dd>
<dt>/echo [text]</dt> <dd>Displays the text on current window </dd>
<dt>/google <text></dt> <dd>Opens default browser, and sends the specified text to Google search. </dd>

</dl>

__FORCETOC__

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

Plugins

2018-02-05T21:00:45Z

IceCold: typo fix

IceChat plugins are a way to enhance the client functionality. 
The [https://github.com/icechat/IceChat/ source code] has a Plugin folder, with a Blank Plugin template to work from.

All installed plugins must be placed in a Plugins subfolder under the installation folder (which by default is located in ([https://en.wikipedia.org/wiki/Environment_variable#Default_values %ProgramFiles%]\IceChat9)

The Plugins Folder can be opened from the Browse Plugins Folder under the Help menu.

Initially, IceChat comes with an optional Highlite plugin. Several others are available for download on the IceChat 9 Plugins of the site's [http://www.icechat.net/site/downloads/download.php?category=4 download] page, each listed below.

== Google Plugin ==
This plugin performs a Google search.

Type <code>!google</code> in the [[Layout#Default Layout|Input Line]], followed by the desired search string. 
Several (usually 5) top results will be displayed on the current tab.

== High lite Plugin ==
This plugin highlights user defined words on a channel window. 
It's settings tab is part of the [[Colors]] settings of IceChat and explained [[Colors#High Lite tab|there]].

== Nick High Lite Plugin ==
Similar to the High lite Plugin, this plugin highlights nick names on the [[Layout#Default_Layout|Nick List]] window. 
It's settings tab is part of the [[Colors]] settings of IceChat and explained [[Colors#Nick Hilite tab|there]].

== Simple Script Plugin ==
This plugin allows the user to define some commands in response to events. 

To add or edit a command, open the IceChat Editor from the Tool Bar or the Options menu entry, or by the key shortcut <code>CTRL+S</code>.

The Simple Script tab lists all the existing commands. Each command can be temporarily disabled by un-checking its checkbox.

[[File:ice9-simpleScript.jpg|512px]]

Each command is edited in the Script Item window.

[[File:ice9-simple-script-item.jpg]]

The example in the screenshot is designed to help erroneous join statement in #IceChat channel. 
If a user type <code>join #channel</code> (without '/') in #IceChat channel, the following message will be displayed: 
<code>To join a channel, type /join #channel</code> 

<dl>
<dt>Script event </dt>
<dd>Choose the required event from a list. The command will be triggered when this event occurs. </dd>

<dt>Text to match </dt>
<dd>Type the text that will trigger this specific command. The text can be a [https://en.wikipedia.org/wiki/Regular_expression regular expression], as in the above [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx#character_classes example]. </dd>

<dt>Channel/ Nick match </dt>
<dd>where would the command be performed. In the above example, the command will only be displayed in #IceChat channel. 
In case of a nick, the command will be displayed in response to that nick only.</dd>

<dt>Command to run </dt>
<dd>Any IRC command can be used and it can include IceChat Identifiers listed on the [[Identifiers]] page or the [[Colors#Messages tab|Colors' Messages]] page. </dd>

</dl>

== Twitter Plugin ==
The Twitter plugin display tweets from the users listed for it, in colors to differentiate between the accounts. 
To set users to be displayed, open the [[Settings]] window of IceChat from the Tool Bar or the Options menu entry, or by the key shortcut <code>CTRL+P</code>.

[[File:ice9-twitter-settings.jpg|512px]]

The tweets can be displayed on a single @Twitter tab, or on a separate @<user name> tab for each user.

== Buzzen Plugin ==
This plugin connects a user to the Buzzen chat network.
The first time this plugin is used, IceChat requests the email address registered with Buzzen, and the password.

These are sent to the server for authentication, during connection.
== Channel Monitor ==
Using this plugin you can see messages from various channels in a single window. 

[[File:Ice9-Channel-Monitor.jpg|800px]]

The plugin's effect can be switched on or off by right-clicking on the Server Tree channel, and checking / un-checking it.

=== Troubleshooting ===
If, for some reason you cannot see the plugin's window under the status bar, try the following:
<ol>
<li>Make sure the plugin's dll is located in the Plugins folder (see above) </li>
<li>Check that the plugin is enabled in the Options -> Loaded Plugins -> Channel Monitor (under the main menu) </li>
<li>If the plugin is enabled, and still no window is displayed, disable the plugin and then re-enable it</li>
</ol>

[[File:Ice9-Channel-Monitor-window.jpg]]

== Decide Plugin ==
This plugins returns a random string from the several provided strings. 
Syntax: 
<code>!decide string 1,string 2,string 3 </code>,..... 
Each time the command will return one of the strings randomally.

== Bible Plugin ==
This plugin returns a quote of a requested verse. 
Syntax: 
<code>!bible [book name] [chapter:verse] </code> 

Example: 
<code>!bible Proverbs 18:21</code> 
Result: 
<code>Death and life are in the power of the tongue, and those who love its use will eat its fruit </code> 

<cite>IceChat results are from the [https://bible.org/ bible.org] site</cite>

[[Category:IceChat 9]]
[[Category:Common Usage]]
[[Category:Advance Usage]]
[[Category:Settings]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

Build from source code

2018-01-27T22:06:05Z

IceCold: Added a BuildIceChat.latest batch file to the build folder using .NET 4.7.1

IceChat 9 is an open source program, which means the source code is available to anyone.

The source code is updated more often then the full installs/updates and is located at https://github.com/icechat/IceChat

Download the latest source code from the page, by clicking on the Download Zip button.

Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the [https://en.wikipedia.org/wiki/Environment_variable#Default_values %CommonProgramFiles%], because of permissions possible limitations.

The source tree has several text files in its root folder, a build folder and a src, where the actual code and resources are located in several sub-folders. 

There are several build options in the extracted root folder.
<dl>
<dt>BuildIceChat.cmd</dt> <dd>which uses .NET 3.5, and should be used by XP users</dd>
<dt>BuildIceChat-x86.cmd</dt> <dd> which uses .NET 3.5 and a specific project for x86 computers. This too can be used by XP users.
</dd>
<dt>BuildIceChat.4.5.cmd </dt> <dd> which uses .NET 4.5.
</dd>
<dt>BuildIceChat.4.5-x86.cmd </dt> <dd>which uses .NET 4.5 and a specific project for x86 computers.
</dd>
<dt>BuildIceChat.latest.cmd </dt> <dd> which uses .NET 4.7.1
</dd>
<dt>BuildIceChatLinux.sh </dt> <dd>A script to build IceChat 9 under Linux. See [[IceChat on Linux]] for details.
</dd>
</dl>
If you are not sure which version to choose, and your OS is later then XP, use the BuildIceChat.4.5.cmd. 

You can either double click on the BuildIceChat.4.5.cmd file or open a command line window (cmd.exe) and run the BuildIceChat.4.5.cmd at the prompt. 

You will get at the end of the process the following lines:
<pre>
0 Error(s)

Time Elapsed 00:00:00.32
..\src\IceChat\bin\Debug\IceChat2009.exe
1 File(s) copied
..\src\IceChat\\bin\Debug\IPluginIceChat.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IRCConnection.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IThemeIceChat.dll
1 File(s) copied
IceChat files copied to the IceChatBuild folder
Press any key to continue . . .
</pre>

A new folder is created called IceChatBuild, and once the batch file has completed, 4 files will be placed in this folder. 
A log file named <code>Manual_MSBuild_ReleaseVersion_LOG.log</code> is also created.

Copy these 4 files into your IceChat installation folder, or place them anywhere else you want.

To see all the changes from build to build, read the changelog.txt file in the root folder.
==Troubleshooting==

If the BuildIceChat.cmd returns errors, try instead to run the newer IceChatBuild.4.5.cmd which was specifically created for users who have errors with IceChatBuild.cmd.


If you experience problems connecting to servers with SSL, try build with IceChatBuild.4.5.cmd

==Sources==
Get Microsoft .NET Framework 4.5.2 at [https://www.microsoft.com/en-ca/download/details.aspx?id=42642 this] link.
[[Category:IceChat 9]]
[[Category:Initial]]
[[Category:Advance Usage]]
[[Category:Linux]]

Commands

2018-01-09T19:31:52Z

IceCold: add missing "]" in the /server examples

IceChat 9 has a long list of commands that can be used in [[Popup Menus]], [[Aliases]] or the [[Layout#Default Layout | Input Line]].

The following conventions are used: 
<ul>
<li>Angle brackets <code>< ></code> represent a placeholder which should be replaced with actual values. </li>
<li>Square brackets <code>[ ]</code> represent optional parameters. </li>
<li>Pipe <code>|</code> represents a choice between several options for a single parameter. For example, <code>/topicbar <show | hide></code> means that the command can be used with <code>show</code> or <code>hide</code>. </li>
</ul>

== IRC related commands ==
This section includes commands that are either defined in the [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Technical_information IRC protocols] or were created in IceChat in order to make life easier for its users. Example, <code>/part</code> is an IRC command that leaves a specific channel. <code>/partall</code> extends that to leaving all the channels on a current server.

A complete list of IRC commands, with their syntax and description is found on [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands Wikipedia].

<dl>
<dt>/ame <text></dt><dd>Sends the text action to all channels you're currently on, on the current server.</dd>
<dt>/amsg <text></dt> <dd>Sends a message to all channels you're currently on, on the current server.</dd>
<dt>/anick <nickname></dt> <dd>Changes your current nickname to the specified nickname on all conected servers </dd>
<dt>/aquit, /quitall</dt> <dd>Disconnect all servers </dd>
<dt>/autojoin <#channel></dt> <dd>Automatically joins the specified channel, or toggles it, if already on the [[New_Server#Auto_Join_tab | AutoJoin]] list of the current [[New_Server#New_Server.2F_Network | Server]]. </dd>
<dt>/autoperform</dt> <dd>Runs the commands listed on the [[New_Server#AutoPerform_tab | AutoPerform tab]] of the [[New_Server#New_Server.2F_Network | Server Editor]] window on current server </dd>
<dt>/autostart</dt> <dd>Toggles the [[New_Server#Extra_Settings_tab|Connect on startup]] option for the current server. </dd>
<dt>/away</dt> <dd>Toggles your status between <code>away</code> and <code>not away</code>. Follows the options defined in the [[Settings#Away_tab | Away settings]]. </dd>
<dt>/aaway</dt> <dd>The above described <code>away</code> command is sent to all the connected servers. </dd>
<dt>/ban <#channel> <nickname | address><dt> or <dt>/mode <#channel> +b <nickname | address> </dt> <dd>A ban is a channel mode that is set to prevent clients with certain IRC identifiers (username, hostname, nickname) from joining that channel. Channel bans can only be set and removed by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. 
The ban is applied to the specified user/address for the specified channel. A ban can be removed with the <code>/mode <#channel> -b <nickname | address></code> command.</dd>
<dt>/forcequit</dt> <dd>Forces the current server to disconnect. </dd>
<dt>/hop</dt> <dd>Parts and re-joins the current channel. </dd>
<dt>/ignore <enable | disable></dt> <dd>Toggles the [[New_Server#Ignore_List_tab | Ignore List]] option for the current server.</dd>
<dt>/ignore -[p | n | c | i | t | d] <nickname></dt> <dd>Adds the specified nick name to the Ignore List. If the nick name is already on the list, it is un-checked. If none of the optional parameters is specified, then this <nickname> will be ignored on all types. The optional parameters stand for: p=private, n=notice, c=channel, i=invite, t=ctcp, d=dcc </dd>
<dt>/join <#channel></dt> <dd>Joins the specified channel. </dd>
<dt>/kick [#channel] <nickname> [reason]</dt> <dd>Kicks the specified user. If no channel is specieid, the current channel is assumed. If a reason was given, it is displayed. If no reason was provided, the nick of the user who kicked, is displayed. </dd>
<dt>/list </dt> <dd>Opens a Channel List window in which all the channels of the current server are listed. This list can be very long for the big networks. </dd>
<dt>/mode <nickname> <flags></dt> or <dt>/mode <#channel> <flags></dt> <dd>Sets the specified channel or nick name to the requested mode. Channel modes can be set only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. The supported modes depend on the specific network. Usually, the server's [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands#MOTD MOTD] lists the supported modes, or they can be found on the network documentation.</dd>
<dt>/modex</dt> <dd>Similar to /mode. Mostly, unsupported by networks. </dd>
<dt>/motd</dt> <dd>Displays the server's Message Of The Day on the console tab. </dd>
<dt>/names <#channel></dt> <dd>Displays a list of the users in the specified channel and their access levels (rank) on that channel. </dd>
<dt>/nick <nickname></dt> <dd>Changes the your current nick to the specified nick name. </dd>
<dt>/notice <nickname> <text></dt> <dd>Displays the specified text on the server's window of the specified user and on your current window. No automatic answer is returned. </dd>
<dt>/onotice [#channel] <message></dt> <dd>Sends the specified notice message to all channel ops. Not supported by all networks. </dd>
<dt>/part</dt> <dd>Parts from the current channel. </dd>
<dt>/partall</dt> <dd>Parts from all channels on current server </dd>
<dt>/ping <nickname></dt> <dd>Pings the specified nickname. </dd>
<dt>/query <nickname> <message></dt> <dd>Opens a private window for chat between you and the specified user. If the <nickname> is away and has an automatic away message, that message will be sent back. </dd>
<dt>/quit</dt> <dd>Disconnects the current server. </dd>
<dt>/spartall</dt> <dd>Parts all channels on all servers. </dd>
<dt>/topic [text]</dt> <dd>Displays the topic of the current channel. It any text is added to the command, the channel topic will be set to that text. Topic can be changed only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel's operators]. </dd>
<dt>/umode <flags></dt> <dd>Same as <code>/mode <myNickName> <flags></code>. See <code>/mode</code> above.</dd>
<dt>/version</dt> <dd>Returns the version of the current server. </dd>
<dt>/who <#channel></dt> <dd>Lists all the users on the specified channel. </dd>
<dt>/whois <nickname></dt> <dd>Returns info about the specified nick name. </dd>
</dl>

== Client features commands ==
This section includes commands that are specific to the client and were made to extend the user experience. for example, <code>/buddylist nickname</code> adds a specified nick to the buddy list. Alternately, this could have been achieved using the [[New_Server#Buddy_List_tab | GUI]] instead.

<dl>
<dt>/aline @<window name> <text></dt> <dd>Adds the specified text to the specified window. If the window does not exist, it will be opened. Example: <code>/aline @temp This is a test</code></dd>
<dt>/attach</dt> <dd>Re-attaches the current window back into the main program. (Counteracts the <code>/Detach</code> command.) </dd>
<dt>/bgcolor <color></dt> <dd>Changes the background color for the current window. The [[Colors#Colors_Palette | color]] parameter must be a number between 0 and 71. </dd>
<dt>/buddylist <nickname></dt> <dd>Adds the specified nickname to the buddy list. </dd>
<dt>/ctcp <nickname> <ping | finger | version | time | userinfo | clientinfo></dt> <dd>Performs the given ctcp request on the specified nickname. </dd>
<dt>/chaninfo [#channel]</dt> <dd>Opens a channel information window for the specified channel, or the current if no channel is specified. </dd>
<dt>/clear</dt> <dd>Clears the text of the current window. </dd>
<dt>/clearall</dt> <dd>Clears the text of all windows on all servers, including console. </dd>
<dt>/closeall</dt> <dd>Closes all the windows that were opened with <code>/window</code> or <code>/aline</code> commands. </dd>
<dt>/close</dt> <dd>Closes the current window </dd>
<dt>/closequery, /closeallquery</dt> <dd>Closes all your query windows on the current server.</dd>
<dt>/colormode [#channel]</dt> <dd>Toggles The No Color mode entry on the context menu of the specified channel. If no channel is specified, the current channel is assumed.</dd>
<dt>/cplay <#channel> <filename></dt> <dd>Similar to <code>/play</code> but checks if the sounds on the specified channels are muted. If they are, it won't play. </dd>
<dt>/detach</dt> <dd>Detaches the current window out of main program and onto its own. </dd>
<dt>/dcc chat <nickname></dt> <dd>Opens a dcc window and sends a dcc chat request to the specified user. </dd>
<dt>/dcc send <nickname> {file1} {file2} {file3} ... {fileN}</dt> <dd>Sends the specified files to the specified user. </dd>
<dt>/describe <#channel> <text></dt> <dd>Creates a self action with the specified text on the specified channel.(Similar to the <code>/me</code> command but for the specified channel.) </dd>
<dt>/debug</dt> <dd>Opens the debug window. </dd>
<dt>/export</dt> <dd>Exports the result of the <code>/list</code> command into a file. The user is prompted for the filename and location. The Channel List window must be the active window. </dd>
<dt>/font <#channel></dt> <dd>Opens the [[Settings#Fonts_tab|Fonts]] window for the user to choose a font. All text in the specified channel is changed to the selected font. The new setting is active only until the window is closed. </dd>
<dt>/flash <#channel> [off]</dt> <dd>Causes a specific channel to blink. <code>off</code> stops the blinking. </dd>
<dt>/flashtask, /flashtaskbar</dt> <dd>Causes the tasbkbar to blink </dd>
<dt>/flashtray <message></dt> <dd>Sends the specified message to the System Tray icon to show in a Balloon </dd>
<dt>/flashing</dt> <dd>This command toggles the flashing of the current channel on the Events->Flashing entry of the channel's context menu for the [[Layout#Default_Layout | channel bar]] and [[Layout#Default_Layout | server tree]]. </dd>
<dt>/icechat</dt> <dd>Returns the client name (IceChat), followed by the current version and build number. </dd>
<dt>/icepath</dt> <dd>Returns the path to the program. </dd>
<dt>/joinserv <irc.server.name> <#channel></dt> <dd>Connects to the specified server with [[New_Server#Default_Server_Settings |IceChat default nick name]] and joins the specified channel. </dd>
<dt>/logging</dt> <dd>Toggles the Disable Logging entry on the [https://en.wikipedia.org/wiki/Context_menu context menu] for the cureent channel. </dd>
<dt>/loadorder</dt> <dd>Loads a previously saved order of channel tabs on the tab bar. (See <code>/saveorder</code>)</dd>
<dt>/me <text></dt> <dd>Displays a self action with the specified text in the current channel. </dd>
<dt>/msg <nickname> <text></dt> <dd>Opens a window with a private message for the specified user under the current server. If the user is away and has set an automatic "away" answer, you'll get that answer. </dd>
<dt>/notify <nickname></dt> <dd>Adds the nickname to the buddy list. </dd>
<dt>/pin <#channel></dt> <dd>Iconifies the channel tab on the channel bar. </dd>
<dt>/play <filename></dt> <dd>Plays the <filename>. <filename> should include the full path, and it must be either a WAV or mp3 file. 
Example:
<code>/play d:\my music\Yellow Submarine.mp3</code> </dd>
<dt>/quote, /raw</dt> <dd>Sends raw server messages. 
Example:
<code>/quote whois Snerf</code></dd>
<dt>/run <program></dt> <dd>Runs a program. The full path and name must be provided. </dd>
<dt>/say <text></dt> <dd>Displays the specified text on the active window. </dd>
<dt>/saveorder</dt> <dd>Saves the current order of the channels on the tab bar to <code>ChannelSetting.xml</code> in the [[Data Folder]]. </dd>
<dt>/scid <serverID/NetworkName> </command> [parameters]</dt> <dd>Sends the specified command to the specified network or server number. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]] 
Example:
/scid quakenet /join #icechat</dd>
<dt>/server [-e] <server:[+]port> [port] [-i nick] [-j #channel password]</dt> or <dt>/server id=<serverId> </dt> <dd> This command connects to the specified server. 
If no port is specified, it'll use port 6667. 
<code>-e</code> parameter means to connect with SSL. Alternately, the + sign before the port number means to connect with SSL. In both cases, the SSL port must be provided, or the connection will fail. 
<code>-i</code> parameter followed by a nick, specify the requested nick. If no nick is provided, [[New_Server#Default_Server_Settings |IceChat default nick name]] will be used. 
<code>-j</code> parameter followed by a channel, specifiy the channel to join after the server is connected. 
serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]]. 
Examples: 
<code>/server irc.quakenet.org:6667 [-i IceChat9] [-j #IceChat]</code> 
<code>/server irc.freenode.net:+7000 [-i IceChat9] [-j #IceChat]</code>
</dd>
<dt>/sounds</dt> <dd>Toggles the sounds of the current channel on the Events->Sounds entry of the current channel's context menu. </dd>
<dt>/sound <#channel></dt> <dd>Toggles sounds for the specified channel on the context menu of that channel's Events->Sounds entry. </dd>
<dt>/switch #channel serverID</dt> <dd>Switches to the specified channel window under the specified server. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]].</dd>
<dt>/timers</dt> <dd>Displays all current timers on the current server. </dd>
<dt>/timer [-g]<n> <repetitions> <interval (in seconds)> <command></dt> <dd>This command allows delay before performing the specified command. 
<code>-g</code> is an optional parameter, which stands for global. Global timers can run without any server connected. 
<code>n</code> is a number required to identify the timer. 
<code>repetitions</code> is the number of times that the specified command will run. 
<code>interval</code> is the time gap between running the specified command. 
<code>command</code> is an IRC command to run.
</dd>
<dt>/topicbar <show | hide></dt> <dd>Displays or hides the [[Layout#Default_Layout | topic bar]]. </dd>
<dt>/totray</dt> <dd>Minimizes the client to the system tray. If you want to load IceChat directly into the system tray, add this command in the [[Settings#Startup tab | Settings' Startup tab]]. </dd>
<dt>/update</dt> <dd>Checks if a new version of IceChat is available. </dd>
<dt>/userinfo <nickname></dt> <dd>Opens a User info window with information about the specified nick name.</dd>
<dt>/window @<name></dt><dd>Opens a window with the specified name. Example: <code>/window @tests</code></dd>
<dt>/unpin <#channel></dt> <dd>Reverses the <code>/pin</code> command. The channel name is re-displayed on the channel bar. </dd>
</dl>

== General features ==
This section includes commands that are not directly related to IRC or the client features. For example, opening the default browser or sending a Google search to the browser.

<dl>
<dt>/beep</dt> <dd>Sounds the Windows' beep.</dd>
<dt>/browser <url></dt> <dd>Opens the default browser with the specified url. /dd>
<dt>/dns <address></dt> <dd>Returns the IP of the address </dd>
<dt>/echo [text]</dt> <dd>Displays the text on current window </dd>
<dt>/google <text></dt> <dd>Opens default browser, and sends the specified text to Google search. </dd>

</dl>

__FORCETOC__

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

Commands

2018-01-09T19:25:23Z

IceCold: add + for SSL port in /server command

IceChat 9 has a long list of commands that can be used in [[Popup Menus]], [[Aliases]] or the [[Layout#Default Layout | Input Line]].

The following conventions are used: 
<ul>
<li>Angle brackets <code>< ></code> represent a placeholder which should be replaced with actual values. </li>
<li>Square brackets <code>[ ]</code> represent optional parameters. </li>
<li>Pipe <code>|</code> represents a choice between several options for a single parameter. For example, <code>/topicbar <show | hide></code> means that the command can be used with <code>show</code> or <code>hide</code>. </li>
</ul>

== IRC related commands ==
This section includes commands that are either defined in the [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Technical_information IRC protocols] or were created in IceChat in order to make life easier for its users. Example, <code>/part</code> is an IRC command that leaves a specific channel. <code>/partall</code> extends that to leaving all the channels on a current server.

A complete list of IRC commands, with their syntax and description is found on [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands Wikipedia].

<dl>
<dt>/ame <text></dt><dd>Sends the text action to all channels you're currently on, on the current server.</dd>
<dt>/amsg <text></dt> <dd>Sends a message to all channels you're currently on, on the current server.</dd>
<dt>/anick <nickname></dt> <dd>Changes your current nickname to the specified nickname on all conected servers </dd>
<dt>/aquit, /quitall</dt> <dd>Disconnect all servers </dd>
<dt>/autojoin <#channel></dt> <dd>Automatically joins the specified channel, or toggles it, if already on the [[New_Server#Auto_Join_tab | AutoJoin]] list of the current [[New_Server#New_Server.2F_Network | Server]]. </dd>
<dt>/autoperform</dt> <dd>Runs the commands listed on the [[New_Server#AutoPerform_tab | AutoPerform tab]] of the [[New_Server#New_Server.2F_Network | Server Editor]] window on current server </dd>
<dt>/autostart</dt> <dd>Toggles the [[New_Server#Extra_Settings_tab|Connect on startup]] option for the current server. </dd>
<dt>/away</dt> <dd>Toggles your status between <code>away</code> and <code>not away</code>. Follows the options defined in the [[Settings#Away_tab | Away settings]]. </dd>
<dt>/aaway</dt> <dd>The above described <code>away</code> command is sent to all the connected servers. </dd>
<dt>/ban <#channel> <nickname | address><dt> or <dt>/mode <#channel> +b <nickname | address> </dt> <dd>A ban is a channel mode that is set to prevent clients with certain IRC identifiers (username, hostname, nickname) from joining that channel. Channel bans can only be set and removed by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. 
The ban is applied to the specified user/address for the specified channel. A ban can be removed with the <code>/mode <#channel> -b <nickname | address></code> command.</dd>
<dt>/forcequit</dt> <dd>Forces the current server to disconnect. </dd>
<dt>/hop</dt> <dd>Parts and re-joins the current channel. </dd>
<dt>/ignore <enable | disable></dt> <dd>Toggles the [[New_Server#Ignore_List_tab | Ignore List]] option for the current server.</dd>
<dt>/ignore -[p | n | c | i | t | d] <nickname></dt> <dd>Adds the specified nick name to the Ignore List. If the nick name is already on the list, it is un-checked. If none of the optional parameters is specified, then this <nickname> will be ignored on all types. The optional parameters stand for: p=private, n=notice, c=channel, i=invite, t=ctcp, d=dcc </dd>
<dt>/join <#channel></dt> <dd>Joins the specified channel. </dd>
<dt>/kick [#channel] <nickname> [reason]</dt> <dd>Kicks the specified user. If no channel is specieid, the current channel is assumed. If a reason was given, it is displayed. If no reason was provided, the nick of the user who kicked, is displayed. </dd>
<dt>/list </dt> <dd>Opens a Channel List window in which all the channels of the current server are listed. This list can be very long for the big networks. </dd>
<dt>/mode <nickname> <flags></dt> or <dt>/mode <#channel> <flags></dt> <dd>Sets the specified channel or nick name to the requested mode. Channel modes can be set only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel operators]. The supported modes depend on the specific network. Usually, the server's [https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands#MOTD MOTD] lists the supported modes, or they can be found on the network documentation.</dd>
<dt>/modex</dt> <dd>Similar to /mode. Mostly, unsupported by networks. </dd>
<dt>/motd</dt> <dd>Displays the server's Message Of The Day on the console tab. </dd>
<dt>/names <#channel></dt> <dd>Displays a list of the users in the specified channel and their access levels (rank) on that channel. </dd>
<dt>/nick <nickname></dt> <dd>Changes the your current nick to the specified nick name. </dd>
<dt>/notice <nickname> <text></dt> <dd>Displays the specified text on the server's window of the specified user and on your current window. No automatic answer is returned. </dd>
<dt>/onotice [#channel] <message></dt> <dd>Sends the specified notice message to all channel ops. Not supported by all networks. </dd>
<dt>/part</dt> <dd>Parts from the current channel. </dd>
<dt>/partall</dt> <dd>Parts from all channels on current server </dd>
<dt>/ping <nickname></dt> <dd>Pings the specified nickname. </dd>
<dt>/query <nickname> <message></dt> <dd>Opens a private window for chat between you and the specified user. If the <nickname> is away and has an automatic away message, that message will be sent back. </dd>
<dt>/quit</dt> <dd>Disconnects the current server. </dd>
<dt>/spartall</dt> <dd>Parts all channels on all servers. </dd>
<dt>/topic [text]</dt> <dd>Displays the topic of the current channel. It any text is added to the command, the channel topic will be set to that text. Topic can be changed only by [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Channel_Operators channel's operators]. </dd>
<dt>/umode <flags></dt> <dd>Same as <code>/mode <myNickName> <flags></code>. See <code>/mode</code> above.</dd>
<dt>/version</dt> <dd>Returns the version of the current server. </dd>
<dt>/who <#channel></dt> <dd>Lists all the users on the specified channel. </dd>
<dt>/whois <nickname></dt> <dd>Returns info about the specified nick name. </dd>
</dl>

== Client features commands ==
This section includes commands that are specific to the client and were made to extend the user experience. for example, <code>/buddylist nickname</code> adds a specified nick to the buddy list. Alternately, this could have been achieved using the [[New_Server#Buddy_List_tab | GUI]] instead.

<dl>
<dt>/aline @<window name> <text></dt> <dd>Adds the specified text to the specified window. If the window does not exist, it will be opened. Example: <code>/aline @temp This is a test</code></dd>
<dt>/attach</dt> <dd>Re-attaches the current window back into the main program. (Counteracts the <code>/Detach</code> command.) </dd>
<dt>/bgcolor <color></dt> <dd>Changes the background color for the current window. The [[Colors#Colors_Palette | color]] parameter must be a number between 0 and 71. </dd>
<dt>/buddylist <nickname></dt> <dd>Adds the specified nickname to the buddy list. </dd>
<dt>/ctcp <nickname> <ping | finger | version | time | userinfo | clientinfo></dt> <dd>Performs the given ctcp request on the specified nickname. </dd>
<dt>/chaninfo [#channel]</dt> <dd>Opens a channel information window for the specified channel, or the current if no channel is specified. </dd>
<dt>/clear</dt> <dd>Clears the text of the current window. </dd>
<dt>/clearall</dt> <dd>Clears the text of all windows on all servers, including console. </dd>
<dt>/closeall</dt> <dd>Closes all the windows that were opened with <code>/window</code> or <code>/aline</code> commands. </dd>
<dt>/close</dt> <dd>Closes the current window </dd>
<dt>/closequery, /closeallquery</dt> <dd>Closes all your query windows on the current server.</dd>
<dt>/colormode [#channel]</dt> <dd>Toggles The No Color mode entry on the context menu of the specified channel. If no channel is specified, the current channel is assumed.</dd>
<dt>/cplay <#channel> <filename></dt> <dd>Similar to <code>/play</code> but checks if the sounds on the specified channels are muted. If they are, it won't play. </dd>
<dt>/detach</dt> <dd>Detaches the current window out of main program and onto its own. </dd>
<dt>/dcc chat <nickname></dt> <dd>Opens a dcc window and sends a dcc chat request to the specified user. </dd>
<dt>/dcc send <nickname> {file1} {file2} {file3} ... {fileN}</dt> <dd>Sends the specified files to the specified user. </dd>
<dt>/describe <#channel> <text></dt> <dd>Creates a self action with the specified text on the specified channel.(Similar to the <code>/me</code> command but for the specified channel.) </dd>
<dt>/debug</dt> <dd>Opens the debug window. </dd>
<dt>/export</dt> <dd>Exports the result of the <code>/list</code> command into a file. The user is prompted for the filename and location. The Channel List window must be the active window. </dd>
<dt>/font <#channel></dt> <dd>Opens the [[Settings#Fonts_tab|Fonts]] window for the user to choose a font. All text in the specified channel is changed to the selected font. The new setting is active only until the window is closed. </dd>
<dt>/flash <#channel> [off]</dt> <dd>Causes a specific channel to blink. <code>off</code> stops the blinking. </dd>
<dt>/flashtask, /flashtaskbar</dt> <dd>Causes the tasbkbar to blink </dd>
<dt>/flashtray <message></dt> <dd>Sends the specified message to the System Tray icon to show in a Balloon </dd>
<dt>/flashing</dt> <dd>This command toggles the flashing of the current channel on the Events->Flashing entry of the channel's context menu for the [[Layout#Default_Layout | channel bar]] and [[Layout#Default_Layout | server tree]]. </dd>
<dt>/icechat</dt> <dd>Returns the client name (IceChat), followed by the current version and build number. </dd>
<dt>/icepath</dt> <dd>Returns the path to the program. </dd>
<dt>/joinserv <irc.server.name> <#channel></dt> <dd>Connects to the specified server with [[New_Server#Default_Server_Settings |IceChat default nick name]] and joins the specified channel. </dd>
<dt>/logging</dt> <dd>Toggles the Disable Logging entry on the [https://en.wikipedia.org/wiki/Context_menu context menu] for the cureent channel. </dd>
<dt>/loadorder</dt> <dd>Loads a previously saved order of channel tabs on the tab bar. (See <code>/saveorder</code>)</dd>
<dt>/me <text></dt> <dd>Displays a self action with the specified text in the current channel. </dd>
<dt>/msg <nickname> <text></dt> <dd>Opens a window with a private message for the specified user under the current server. If the user is away and has set an automatic "away" answer, you'll get that answer. </dd>
<dt>/notify <nickname></dt> <dd>Adds the nickname to the buddy list. </dd>
<dt>/pin <#channel></dt> <dd>Iconifies the channel tab on the channel bar. </dd>
<dt>/play <filename></dt> <dd>Plays the <filename>. <filename> should include the full path, and it must be either a WAV or mp3 file. 
Example:
<code>/play d:\my music\Yellow Submarine.mp3</code> </dd>
<dt>/quote, /raw</dt> <dd>Sends raw server messages. 
Example:
<code>/quote whois Snerf</code></dd>
<dt>/run <program></dt> <dd>Runs a program. The full path and name must be provided. </dd>
<dt>/say <text></dt> <dd>Displays the specified text on the active window. </dd>
<dt>/saveorder</dt> <dd>Saves the current order of the channels on the tab bar to <code>ChannelSetting.xml</code> in the [[Data Folder]]. </dd>
<dt>/scid <serverID/NetworkName> </command> [parameters]</dt> <dd>Sends the specified command to the specified network or server number. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]] 
Example:
/scid quakenet /join #icechat</dd>
<dt>/server [-e] <server:[+]port> [port] [-i nick] [-j #channel password]</dt> or <dt>/server id=<serverId> </dt> <dd> This command connects to the specified server. 
If no port is specified, it'll use port 6667. 
<code>-e</code> parameter means to connect with SSL. Alternately, the + sign before the port number means to connect with SSL. In both cases, the SSL port must be provided, or the connection will fail. 
<code>-i</code> parameter followed by a nick, specify the requested nick. If no nick is provided, [[New_Server#Default_Server_Settings |IceChat default nick name]] will be used. 
<code>-j</code> parameter followed by a channel, specifiy the channel to join after the server is connected. 
serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]]. 
Examples: 
<code>/server irc.quakenet.org:6667 [-i IceChat9] [-j #IceChat</code> 
<code>/server irc.freenode.net:+7000 [-i IceChat9] [-j #IceChat</code>
</dd>
<dt>/sounds</dt> <dd>Toggles the sounds of the current channel on the Events->Sounds entry of the current channel's context menu. </dd>
<dt>/sound <#channel></dt> <dd>Toggles sounds for the specified channel on the context menu of that channel's Events->Sounds entry. </dd>
<dt>/switch #channel serverID</dt> <dd>Switches to the specified channel window under the specified server. serverID is the ordinal number of the server on the [[Layout#Server_Tree|Server Tree]].</dd>
<dt>/timers</dt> <dd>Displays all current timers on the current server. </dd>
<dt>/timer [-g]<n> <repetitions> <interval (in seconds)> <command></dt> <dd>This command allows delay before performing the specified command. 
<code>-g</code> is an optional parameter, which stands for global. Global timers can run without any server connected. 
<code>n</code> is a number required to identify the timer. 
<code>repetitions</code> is the number of times that the specified command will run. 
<code>interval</code> is the time gap between running the specified command. 
<code>command</code> is an IRC command to run.
</dd>
<dt>/topicbar <show | hide></dt> <dd>Displays or hides the [[Layout#Default_Layout | topic bar]]. </dd>
<dt>/totray</dt> <dd>Minimizes the client to the system tray. If you want to load IceChat directly into the system tray, add this command in the [[Settings#Startup tab | Settings' Startup tab]]. </dd>
<dt>/update</dt> <dd>Checks if a new version of IceChat is available. </dd>
<dt>/userinfo <nickname></dt> <dd>Opens a User info window with information about the specified nick name.</dd>
<dt>/window @<name></dt><dd>Opens a window with the specified name. Example: <code>/window @tests</code></dd>
<dt>/unpin <#channel></dt> <dd>Reverses the <code>/pin</code> command. The channel name is re-displayed on the channel bar. </dd>
</dl>

== General features ==
This section includes commands that are not directly related to IRC or the client features. For example, opening the default browser or sending a Google search to the browser.

<dl>
<dt>/beep</dt> <dd>Sounds the Windows' beep.</dd>
<dt>/browser <url></dt> <dd>Opens the default browser with the specified url. /dd>
<dt>/dns <address></dt> <dd>Returns the IP of the address </dd>
<dt>/echo [text]</dt> <dd>Displays the text on current window </dd>
<dt>/google <text></dt> <dd>Opens default browser, and sends the specified text to Google search. </dd>

</dl>

__FORCETOC__

[[Category:IceChat 9]]
[[Category:Advance Usage]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

New Server

2017-11-17T05:43:06Z

IceCold: added a picture of the "add new server" placement and re-arrange the initial paragraph

== New Server/ Network ==
[[File:Ice9-add-new-server.jpg]] 

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

The Server Editor window is opened. 

[[File:Ice9-new-server.jpg]]

All the server's information is added or edited on this window.

The Main Settings tab includes the minimum set of options which are required for a functional server. These are described under the Required Settings heading. 
The additional set of options are described afterwards, in the following sections.

The main window's parts are described on the [[layout]] page. 

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
: Nick: IceChat9 
: Alt nick: IceChat9_ 
: Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
</dl>
<h3>Extra Settings tab</h3>
<dl>
<dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
</dl>
<h3>AutoJoin tab</h3>

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

[[File:Ice9-auto-join.jpg]]
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>
</dl>
<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>IRCv3 tab</h3>
[[File:Ice9-IRCv3.jpg]]

<dl>
<dt>Connect with [http://ircv3.net/irc/#sasl-authenticationlooks/ SASL]</dt>
<dd>If the server supports SASL, you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server.
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user go [[Settings#Away_tab| away] or come back.
</dd>
<dt>Account notify:</dt>
<dd> If enabled the user will be notified when other users login to accounts.</dd>
<dt>Change host</dt>
<dd>When enabled the client will be notified when usernames and/or hostnames are changed. This is relevant for users on the same channel(s) with you. This replaces the fake <code>/quit</code>, and the following fake <code>/join</code> messages instead.
</dd>
</dl>
<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Add the BNC information: server address, port number. 
If the BNC requires username and password, add these as well. 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

File:Ice9-add-new-server.jpg

2017-11-17T05:38:53Z

IceCold: IceCold uploaded a new version of File:Ice9-add-new-server.jpg

File:Ice9-add-new-server.jpg

2017-11-17T05:16:57Z

IceCold:

New Server

2017-10-28T08:26:06Z

IceCold: New IRCv3 tab, icons on buttons

== New Server/ Network ==
A Server is added or edited via the Server Editor. When creating a new server, the Server Editor is opened with the minimal set of options which is required to have a functional new server.

This minimal set of tabs and options is described under the Required heading. 
The full set of options is described afterwards, in the following sections.

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

A new server window is opened. This is the Server Editor window.

[[File:Ice9-new-server.jpg]]

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
: Nick: IceChat9 
: Alt nick: IceChat9_ 
: Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
</dl>
<h3>Extra Settings tab</h3>
<dl>
<dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
</dl>
<h3>AutoJoin tab</h3>

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

[[File:Ice9-auto-join.jpg]]
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>
</dl>
<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>IRCv3 tab</h3>
[[File:Ice9-IRCv3.jpg]]

<dl>
<dt>Connect with [http://ircv3.net/irc/#sasl-authenticationlooks/ SASL]</dt>
<dd>If the server supports SASL, you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server.
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user go [[Settings#Away_tab| away] or come back.
</dd>
<dt>Account notify:</dt>
<dd> If enabled the user will be notified when other users login to accounts.</dd>
<dt>Change host</dt>
<dd>When enabled the client will be notified when usernames and/or hostnames are changed. This is relevant for users on the same channel(s) with you. This replaces the fake <code>/quit</code>, and the following fake <code>/join</code> messages instead.
</dd>
</dl>
<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Add the BNC information: server address, port number. 
If the BNC requires username and password, add these as well. 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

File:Ice9-IRCv3.jpg

2017-10-28T08:04:04Z

IceCold:

File:Ice9-IgnoreList.jpg

2017-10-28T08:03:37Z

IceCold: IceCold uploaded a new version of File:Ice9-IgnoreList.jpg

File:Ice9-auto-join.jpg

2017-10-28T08:03:22Z

IceCold: IceCold uploaded a new version of File:Ice9-auto-join.jpg

Auto join settings

File:Ice9-new-server.jpg

2017-10-28T08:02:52Z

IceCold: IceCold uploaded a new version of File:Ice9-new-server.jpg

New Server

2017-10-25T06:30:35Z

IceCold: update the SASL link

== New Server/ Network ==
A Server is added or edited via the Server Editor. When creating a new server, the Server Editor is opened with the minimal set of options which is required to have a functional new server.

This minimal set of tabs and options is described under the Required heading. 
The full set of options is described afterwards, in the following sections.

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

A new server window is opened. This is the Server Editor window.

[[File:ice9-new-server.jpg]]

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
<h3>AutoJoin tab</h3>
[[File:Ice9-auto-join.jpg]]

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
Nick: IceChat9 
Alt nick: IceChat9_ 
Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
<h3>Extra Settings tab</h3>
<dl><dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
If the server supports [http://ircv3.net/irc/#sasl-authenticationlooks/ SASL] then you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server. TBV
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user is idle.
</dd>
<dt>Account notify:</dt>
<dd> If enabled, the client will notify when a user in a channel has changes accounts in services</dd>
</dl>
<h3>Auto Join tab</h3>
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>

<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Add the BNC information: server address, port number. 
If the BNC requires username and password, add these as well. 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

Settings

2017-10-21T21:01:20Z

IceCold: add "auto return"

IceChat 9 Program Settings is the first entry in the Options Menu. It is divided into tabs. Some of the more commonly used settings have also a separate menu entry in the Options Menu. 
The settings defined for the different options are saved in xml files, in the [[Profiles|Data Folder]].

[[File:ice9-settings-main.jpg]]

== Main Settings tab ==
<dl>
<dt>Save window position on exit</dt>
<dd>Remembers the windows position and sizes. When in [[Layout#Windowed_Layout|Windowed Mode]] remembers also the single channel windows sizes and position.</dd>
<dt>Ask to close servers on exit</dt>
<dd>If disabled, the client will close without confirmation when there are connected servers.</dd>
<dt>Keep channel open if kicked</dt>
<dd>Leaves the channel window on, if kicked. Otherwise the window is closed.</dd>
<dt>Minimize to system tray</dt>
<dd>If enabled, the application will remove itself from the task bar when minimized, and will only be displayed on the system tray. Otherwise, both will be visible when minimized.</dd>

<dt>Always show system tray</dt>
<dd>If disabled, will show in the system tray when minimized, according to the Minimize to system tray settings. The icon will be visible according to the [http://windows.microsoft.com/en-US/windows7/Change-how-icons-appear-in-the-notification-area Notification Area Icons] settings. </dd>

<dt>Perform whois on new query</dt>
<dd>If enabled, will perform whois on the 2nd participant of a query. The information will be displayed on the window defined in the [[Settings#Evants tab|Evants tab]].</dd>

<dt>New queries open in the foreground</dt>
<dd>If enabled, a new query window will get the focus. Otherwise, new query windows will stay in the back. </dd>

<dt>Disable all queries</dt>
<dd>If disabled, other users will not be able to initiate a query with you. A query window is used for private chat between two users. </dd>

<dt>Autojoin channel on invite</dt>
<dd>If enabled, any automatic invite to any channel will open the channel window.</dd>

<dt>Time stamp</dt>
<dd>Time stamp formats are according to [http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx .NET format strings]. The most common are:
<dl>
<dt>h</dt><dd>The hour, using a 12-hour clock from 1 to 12.</dd>
<dt>hh</dt><dd>The hour, using a 12-hour clock from 01 to 12.</dd>
<dt>H</dt><dd>The hour, using a 24-hour clock from 0 to 23. </dd>
<dt>HH</dt><dd>The hour, using a 24-hour clock from 00 to 23.</dd>
<dt>m</dt><dd>The minute, from 0 through 59. </dd>
<dt>mm</dt><dd>The minute, from 00 through 59. </dd>
<dt>s</dt><dd>The second, from 00 through 59.</dd>
<dt>t</dt><dd>The first character of the AM/PM designator. </dd>
<dt>tt </dt><dd>The AM/PM designator. </dd>
</dl>
It is possible to set a specific color for the time stamp:

Open the [[Settings#Display tab|Color Picker]] and select the desired color. A code appears on the [[Layout#Default_Layout|Input Line]]. Copy the code (including the symbol at the beginning) into the beginning of the Time Stamp format line.
</dd>
<dt>System tray icon text</dt>
<dd>If there's a text in this line, the System Tray tip will show it when the mouse hovers next to the icon.</dd>

<dt>System tray icon (32x32)</dt>
<dd>If any icon is selected here, it will be used in the System Tray instead the default IceChat 9 System Tray icon. Maximum size supported is 32x32 pixels. The icons are expected to be in the [[Data Folder#Pictures|Pictures Folder]], but can be located anywhere in the system and pointed to.</dd>

<dt>Language</dt>
<dd>IceChat 9 has the prepreration for translation. If the client finds additional language files in the [[Data Folder#Language|Language folder]], this language will be listed in the Language list.</dd>

</dl>

== Display tab ==
<dl>
<dt>Enable windowed mode</dt>
<dd>Toggles between the [[Layout#Windowed Layout|Windowed Layout]] and [[Layout#Default Layout|Default Layout]] </dd>

<dt>Show emoticon picker</dt>
<dd>If enabled, will display the Emoticon Picker [[File:ice9-emoticon-picker.jpg]] on the left corner of the [[Layout#Default Layout|Input Line]], if [[Settings#Emoticon Tab|Use Emoticons]] is checked.</dd>

<dt>Show color picker</dt>
<dd>If enabled, will display the Color Picker [[File:ice9-color-picker.jpg]], 2nd to the left of the [[Layout#Default Layout|Input Line]].</dd>

<dt>Show basic IRC commands</dt>
<dd>If enabled, will display the Basic IRC-commands Helper [[File:ice9-basic-helper.jpg]], to the left of the [[Layout#Default Layout|Input Line]]. The helper contains some basic commands for server, channel and nick, and offers additional help from the connected server. </dd>

<dt>Show status message</dt>
<dd>When enables, displays the Status Bar.</dd>

<dt>Show send button</dt>
<dd>When disabled, hides the Send button to the right of the [[Layout#Default Layout|Input Line]].</dd>

<dt>Show hosts in nick list</dt>
<dd>If enabled, displays the Host part of the Nickname
[[File:ice9-hosts-on-nick-list.jpg]]</dd>

<dt>Show buttons in nick list</dt>
<dd>If enabled, displays [[Layout#Default Layout|Nick List Buttons]]</dd>

<dt>Show buttons in nick server</dt>
<dd>If enabled, displays [[Layout#Default Layout|Server Buttons]]</dd>

<dt>Show topic bar in channels</dt>
<dd>If enabled, displays [[Layout#Default Layout|Topic Bar]] at the top of each channel's window.</dd>

<dt>Show unread text marker</dt>
<dd>If enabled, shows a thin line marking the last data content on a tab, before the focus was changed to another tab.</dd>

<dt>Single row channel bar</dt>
<dd>If enabled, all tabs on the [[Layout#Default Layout|Channel Bar]] are displayed on a single row. Otherwise, tabs are spread on several lines, allowing the channel names to be clearly displayed. </dd>

<dt>Nick complete after text</dt>
<dd>TBC</dd>

<dt>Number of text lines</dt>
<dd>This is the maximum number of lines in a tab window. When a window reaches this number, earlier text is deleted from the window, but can be still found in the log file of that channel/ server/ query. TBV </dd>

<dt>IceChat window transparency</dt>
<dd>IceChat windows can become completely transparent, depending on the level set. Moving the slider show the changes immediately. </dd>

== Notifications tab ==
<dl>
<dt>Flash taskbar on channel message</dt>
<dd>If enabled, will blink the taskbar N times when there's a new message on an open channel.</dd>

<dt>Flash taskbar on channel action</dt>
<dd>If enabled, will blink the taskbar N times when there's a new action on an open channel.</dd>

<dt>Flash taskbar on private message</dt>
<dd>If enabled, will blink the taskbar N times when there's you get a private message.</dd>

<dt>Flash taskbar on private action</dt>
<dd>If enabled, will blink the taskbar N times when there's a new action on an open private message window.</dd>

<dt>N Number of times to flash taskbar</dt>
<dd>The number inserted here will determine the number of blinks on the taskbar, for any of the "Flash Taskbar" enabled options above.</dd>

<dt>Flash server tree channel icons on message</dt>
<dd>If enabled, will blink the channel on which there's a new message, in the [[Layout#Server Tree|Server Tree]]</dd>

<dt>Enable system tray notification</dt>
<dd>This option controlls the availability of its sub options. If disabled, none of the following options will work, even if enabled. </dd>

<dt>Server connection/ disconnection</dt>
<dd>If enabled, and if the above Enable system tray notification is enabled, will display a brief message. TBV</dd>

<dt>Buddy has come online</dt>
<dd>If enabled, and if the above Enable system tray notification is enabled, will display a brief message. TBV</dd>

</dl>

== Logging tab ==
<dl>
<dt>Console</dt>
<dd>If enabled, will keep a log for each of the connected servers.</dd>

<dt>Channel</dt>
<dd>If enabled, will keep a log for each of the open channels.</dd>

<dt>Query</dt>
<dd>If enabled, will keep a log for query windows.</dd>

<dt>Window</dt>
<dd>If enabled, will keep a log for open windows such as the debug window (under the File menu option).</dd>

<dt>Seperate logs per day</dt>
<dd>If enabled, will create a new log file when the date changes at midnight.</dd>

<dt>Logging format</dt>
<dd>By default, logs are saved as plain text files. 
If Colored Text is selected, the colors of the text are also recorded, using the [[Colors|color]] codes of IceChat. 
If HTML format is selected, then HTML tags are added to the log, in addition to keeping the [[Colors|color]] codes of messages, allowing a user-friendly display in a browser.</dd>

<dt>Change logs folder</dt>
<dd>By default, the [[Data Folder#Logs|log]] is located under the [[Data Folder]]. This option allows the user to define another location for the log files.</dd>
</dl>

== Fonts tab ==
The Fonts tab allows setting a different font for several types of windows or GUI elements. Only the Regular attribute is supported.

== DCC tab ==

TBV

<dl>
<dt>Auto accept [https://en.wikipedia.org/wiki/Direct_Client-to-Client DCC] chat requests</dt>
<dd>If disabled, IceChat will open a confirmation message for the user. </dd>

<dt>Only from [[New Server#Buddy List tab|Buddy List]]</dt>
<dd>If enabled, IceChat will allow DCC chats with no additional confirmation, when a Buddy opens a chat.</dd>

<dt>Auto accept DCC file requests</dt>
<dd>If enabled, any file transfer via DCC will start without a confirmation message. </dd>

<dt>Only from Buddy List</dt>
<dd>If enabled, IceChat will allow DCC file transfers from a Buddy with no additional confirmation.</dd>

<dt>Ignore DCC chat requests</dt>
<dd>If enabled, IceChat will reject requests for DCC chat automatically.</dd>

<dt>Ignore DCC file requests</dt>
<dd>If enabled, IceChat will reject requests for DCC fle transfer automatically.</dd>

</dl>

== Sounds tab ==
<dl>
The sounds tab allow the user to define a different sound per each type of event. 
The sounds can be either [https://en.wikipedia.org/wiki/WAV WAV] or [https://en.wikipedia.org/wiki/MP3 MP3] 

The sounds are expected to reside in the [[Data Folder#sounds|Sounds Folder]], but they can reside anywhere in the system, and be pointed to.

<dt>Use external play command</dt>
<dd>If you want to use a specific player, type the command for it in this line.</dd>

<dt>Play sound even if window is active</dt>
<dd>Whether to play a sound for an event, if the window in which the event occured is the active one.</dd>

</dl>

== Emoticons tab ==
Ice Chat 9 comes with a complete set of Emoticons when initially installed. 
Additional Emoticons can be added, or removed. The Keyboard triggers per each Emoticon, can also be changed. 
Each addition or removal of an Emoticon is reflected immediately after saved, in the [[Settings#Display tab|Emoticon Picker]]

<dl>
<dt>Use Emoticons</dt>
<dd>If disabled, removes the [[Settings#Display tab|Emoticon Picker]], and does not display images for the keyboard triggers.</dd>

<dt>Add/ Remove Emoticon</dt>
<dd>Each of these buttons allow the user to add or remove emoticon images respectively.</dd>

<dt>Edit Trigger</dt>
<dd>Keyboard triggers are combination of keys that when typed, display the Emoticon image associated with it. The initial set of Emoticons comes with predefined triggers that can be changed. When adding a new Emoticon the user needs to define a trigger in addition to the image.</dd>

<dt>Browse Folder</dt>
<dd>Opens the [[Data Folder#Emoticons|Emoticons Folder]].</dd>

</dl>

== Events tab ==
In the Events tab the user can set where each of the IRC events will be shown.

The following options are available for each event:
<dl>
<dt>In Console</dt>
<dd>Each one of the events can be displayed in its connected Server tab. </dd>

<dt>In Channel</dt>
<dd>This option is available for most of the events. If selected, that specific event will be displayed in the channel where it occured. </dd>

<dt>In Current</dt>
<dd>For about a third of the events, there is no In Channel options but instead, the user can select to display the event in the tab that is in focus.</dd>

<dt>Hide</dt>
<dd>Each one of the events can be hidden.</dd>
</dl>

== Away tab ==
This option defines whether or not IceChat will inform open channels and queries when a user becomes inactive or returns to be active. Inactive user is still connected and can see the conversations in the open windows when s/he returns to be active.

<dl>'''Variables:'''
<dt>$awayreason</dt>
<dd>This variable holds the text that is populated in the Auto away message option. Initially, when IceChat is installed, the content of this variable is me is now away - Reason : $awayreason</dd>

<dt>$awaytime</dt>
<dd>This variable holds the actual time that the user was inactive. </dd>

<dt> $autoawaytime</dt>
<dd>This variable holds the number that is set in the Auto away minutes option. Initially, when IceChat is installed, the content of this variable is 30 (minutes).</dd>
</dl>

<dl>'''Options:'''
<dt>Away command</dt>
<dd>This is the command that will be sent to inform the world when the user becomes inactive. Initially, the command is designed to send a message to all the open channels and queries (using the /ame command). The initial message is combined of a constant part is now away - Reason: and a second part, which is the content stored in the <code>$awayreason</code> variable. 
Assuming the user name is IceChat, the initial message will state: IceChat is now away - Reason: Auto-Away (Away from Keyboard for 30 minutes).
The user can change the text to be anything s/he wishes.</dd>

<dt>Return command</dt>
<dd>This is the command that will be sent when the user becomes active again. Initially, the message is set to inform all the open channels and queries, that the user was gone for $awaytime number of minutes. The user can set any other message, as desired.</dd>

<dt>Send away/ return messages</dt>
<dd>If disabled, no "Away" messages will be send. </dd>

<dt>Send message to private messangers while away</dt>
<dd>If enabled, an away message will be sent to anyone who initiates a query, even if the Send away/ return messages is disabled.</dd>

<dt>Message to send</dt>
<dd>The text that will be sent to the private messangers, if the above option is enabled.</dd>

<dt>Auto away</dt>
<dd>If enabled, the client will set the user status to away after being inactive for Auto away minutes.</dd>

<dt>Auto away minutes</dt>
<dd>A number of minutes that is optionally used in the Away command and in the Auto away options. The content of this message is stored in the <code>$autoawaytime</code> variable.</dd>

<dt>Auto return</dt>
<dd>If enabled, the client will change the user status back to active when the user sends a message.</dd>

<dt>Auto away when placing IceChat on system tray</dt>
<dd>If enabled, the client will set the user status to away when IceChat is minimized to the system tray.</dd>

<dt>Auto away message</dt>
<dd>This message, if populated, will be displayed when the user status becomes away. The content of this message is stored in the <code>$awayreason</code> variable. </dd>
</dl>

== Startup tab ==
Any command listed in the textbox will be performed as soon as IceChat 9 starts, before starting to connect to servers. 
Use the Auto Perform on Startup checkbox to disable/enable all the commands. 
Use <code>;</code> (semicolon) at the beginning of a line to disable a command. 

<dl>
<dt>Auto Perform on Startup</dt>
<dd>If checked, the commands listed in the textbox will be executed. </dd>
</dl>

[[Category:IceChat 9]]
[[Category:Common Usage]]
[[Category:Settings]]
[[Category:UI]]

New Server

2017-08-27T05:51:20Z

IceCold: 9.17 changes: Advanced Settings checkbox was removed, Ignore list updated

== New Server/ Network ==
A Server is added or edited via the Server Editor. When creating a new server, the Server Editor is opened with the minimal set of options which is required to have a functional new server.

This minimal set of tabs and options is described under the Required heading. 
The full set of options is described afterwards, in the following sections.

Adding new server/ network is easy: 
Press the Add button on the lower part of the [[layout#Server_Tree|Server tree]].

A new server window is opened. This is the Server Editor window.

[[File:ice9-new-server.jpg]]

== Required Settings ==

<h3>Main Settings tab</h3>
<dl>
<dt>Server:</dt>
<dd> the name of the server to connect to. For example irc.freenode.net
</dd>
<dt>Nick:</dt>
<dd> the username you wish to use on this server.</dd>
<dl>
<h3>AutoJoin tab</h3>
[[File:Ice9-auto-join.jpg]]

Type the channel/s name to which you want to join automatically. If the channel has a password (key), add a space after the channel's name, and then type the password. Press the Add button to add the channel to the list of AutoJoin channels.

Remember to add the # (pound) sign before the channel name.

After filling the above information, press the Save button.

The server is displayed on the [[layout#Server_Tree|Server tree]] list, and can be connected.

There are two ways to connect a server:
<ul>
<li>By using the Connect button on the bottom of the [[layout#Server_Tree|Server tree]] list</li>
<li>By right-click the server in the servers list, and selecting the 1st option there, Connect</li>
</ul>

== Default Settings ==

In addition to the above, the following settings are available:
<h3>Main Settings tab</h3>
<dl>
<dt>Display name:</dt>
<dd> the name that will be displayed on the server tree list. for example my_nick@freenode
</dd>
<dt>Ident name:</dt>
<dd> used as part of the host name on the nick list
</dd>
<dt>Quit message:</dt>
<dd> when using the default $randquit, a random funny message is displayed when the user leaves a channel. Any message can be set instead.
</dd>
<dt>Port:</dt>
<dd> The port used for the connection.
</dd>
If Alt nick and Away nick are left blank, IceChat9 sets them automatically based on the selected nick.

Example: 
Nick: IceChat9 
Alt nick: IceChat9_ 
Away nick: IceChat9[A]

<dt>Connect with IPv6:</dt>
<dd> for those who have IPv6 connection.
</dd>
<dt>Connect with SSL:</dt>
<dd> if the server/network has an SSL connection. In this case, the port number should be changed accordigly.
</dd>
<dt>Accept invalid SSL certification:</dt>
<dd> If the previous option is selected, it is highly recommended to check this option.
</dd>
<h3>Extra Settings tab</h3>
<dl><dt> Set mode +i on connect:</dt>
<dd> sets the user mode to invisible when connected to the server. See [https://en.wikipedia.org/wiki/IRC#Modes Wikipedia] for more on IRC modes.
</dd>
<dt>Show MOTD on connect:</dt>
<dd> displays the server's Message of the Day.
</dd>
<dt>Show PING PONG message:</dt>
<dd> By default these messages are not displayed. These messages test the connection with the server.
</dd>
<dt>Rejoin channels on connect:</dt>
<dd> Whether to automatically rejoin the open channels when reconnecting to a disconnected server.
</dd>
<dt>Disable CTCP replies:</dt>
<dd> If enabled, will disable sending CTCP replies to anyone who sends one</dd>
<dt>Disable away/ return messages:</dt>
<dd> If disabled, the client will not inform the server when the user is idle. TBV
</dd>
<dt>Connect on startup:</dt>
<dd> Whether or not you want to connect to this server when the client starts.
</dd>
<dt>Ping timer (minutes):</dt>
<dd> The interval for the PING messages.
<dt>Encoding:</dt>
<dd> The encoding to be used for the server. The default utf-8 value is recommended.
</dd>
<dt>Server password:</dt>
<dd> If the server requires a password, enter it here</dd>
<dt>Nickserv password:</dt>
<dd> If you have registered your nick on the server, adding the password here will allow IceChat to identify with the nick server automatically.
</dd>
If the server supports [http://freenode.net/sasl/ SASL] then you can check the Connect with SASL checkbox. 
The user and password would be the same as for the nick server. TBV
</dd>
<dt>Extended join:</dt>
<dd> If enabled, the client will display extra information on a channel join</dd>
<dt>Away notify:</dt>
<dd> If enabled, the client will notify the server when the user is idle.
</dd>
<dt>Account notify:</dt>
<dd> If enabled, the client will notify when a user in a channel has changes accounts in services</dd>
</dl>
<h3>Auto Join tab</h3>
<dl>
<dt>Enable AutoJoin:</dt>
<dd>This checkbox is enabled automatically when adding a channel for the first time.
when unchecked, none of the channels on the list will be automatically joined.
<dt>AutoJoin delay:</dt>
<dd> Will delay joining to the first channel by the 5 seconds. This allows time for certain commands to be completed, such as the identification with the nick server.
</dd>
<dt>Delay between joins:</dt>
<dd> If checked, there will be a delay of 1 second before each of the channels listed in the AutoJoin window is joined.</dd>

<h3>AutoPerform tab</h3>
This editor allows the user to perform commands after the server is connected. 
The commands can be any regular IRC commands. TBC 
Each command should be in a separate line, starting with / (slash). 
The whole set of commands will only be performed if the Enable AutoPerform checkbox is checked. 
If you want to disable 1 or more lines in the AutoPerform list, start the line with a ; (semi-colon)
<h3>Buddy List tab</h3>
If you want to be informed when certain users connect or disconnect to/ from this server, add their nicks to the list. 
When a buddy connects or disconnects to/ from the server, there will be several indications:
<ul>
<li>The server name on the [[layout#Server_Tree|Server tree]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The Console tab on the [[layout#Default_Layout|Channel Bar]] will be highlighted with the [[colors|Buddy List]] color.</li>
<li>The [[layout#Buddy_List|Buddy list]] window will list the nick under Connected or Disconnected according to that user's status.</li>
</ul>

Buddy list announcement will only be performed if the Enable Buddy list checkbox at the bottom, is checked.

<h3>Default Server Settings</h3>
This tab is shared among all the servers defined for IceChat 9.
If no specific data is inserted when creating a new server, the values from this tab are used.

== Advanced Settings ==
The following tabs provide additional options for a server 

<h3>Ignore List tab</h3>

[[File:ice9-IgnoreList.jpg]]

This tab is similar in looks and UI to AutoJoin tab. 
Adding any nick name to the list will prevent texts from this nick to be displayed on any of the channels of that server. 
There are several ignore channels. The elements are shown on the list columns and a legend is available on the side. 

Fine tuning for the ignored nick is available by editing the nick on the list:

[[File:ice9-IgnoreItemDialog.jpg]]

The . (dot) character can be used as wildcard. 
Example: 
Assuming several bots on channel(s) of a certain server, with the following nick names: 
AnnounceBot 
InfoBot 
.... 
If you want to ignore them, you can add <code>.bot</code> to the Ignore List instead of listing each one separately.

The Ignore List will function only if the Enable Ignore List checkbox at the bottom is checked.

<h3>Notes tab</h3>
This is a place to keep some notes regarding this specific server. TBV
<h3>Proxy Settings tab</h3>
Check the Enable Proxy Connection checkbox if you need to connect through a [https://en.wikipedia.org/wiki/Proxy_server Proxy] Server. 
Add the proxy information: IP address and Port number. 
If the proxy requires username and password, add these as well. 
Choose the relevant protocol as required by the proxy server from the list.

<h3>BNC Settings tab</h3>
Check the Enable BNC Connection checkbox if you need to connect to your [https://en.wikipedia.org/wiki/BNC_%28software%29 BNC]. 
Add the BNC information: server address, port number. 
If the BNC requires username and password, add these as well. 

== Additional Settings ==
<ul>
<li>Display Name: It is possible to set a color for the server name on the [[layout#Server_Tree|Server tree]] the same way as setting the colors for [[colors|Advanced messages]]. </li>
</ul>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:Common Usage]]
[[Category:Server]]

File:Ice9-IgnoreItemDialog.jpg

2017-08-27T05:44:15Z

IceCold:

File:Ice9-IgnoreList.jpg

2017-08-27T05:43:59Z

IceCold:

File:Ice9-new-server.jpg

2017-08-27T05:29:00Z

IceCold:

Build from source code

2017-07-29T18:34:56Z

IceCold: add the Linux script and category

IceChat 9 is an open source program, which means the source code is available to anyone.

The source code is updated more often then the full installs/updates and is located at https://github.com/icechat/IceChat

Download the latest source code from the page, by clicking on the Download Zip button.

Unzip the file into any folder, for example a dedicated "C:\IceChatBuild". It is best not to use the [https://en.wikipedia.org/wiki/Environment_variable#Default_values %CommonProgramFiles%], because of permissions possible limitations.

The source tree has several text files in its root folder, a build folder and a src, where the actual code and resources are located in several sub-folders. 

There are several build options in the extracted root folder.
<dl>
<dt>BuildIceChat.cmd</dt> <dd>which uses .NET 3.5, and should be used by XP users</dd>
<dt>BuildIceChat-x86.cmd</dt> <dd> which uses .NET 3.5 and a specific project for x86 computers. This too can be used by XP users.
</dd>
<dt>BuildIceChat.4.5.cmd </dt> <dd> which uses .NET 4.5.
</dd>
<dt>BuildIceChat.4.5-x86.cmd </dt> <dd>which uses .NET 4.5 and a specific project for x86 computers.
</dd>
<dt>BuildIceChatLinux.sh </dt> <dd>A script to build IceChat 9 under Linux. See [[IceChat on Linux]] for details.
</dd>
</dl>
If you are not sure which version to choose, and your OS is later then XP, use the BuildIceChat.4.5.cmd. 

You can either double click on the BuildIceChat.4.5.cmd file or open a command line window (cmd.exe) and run the BuildIceChat.4.5.cmd at the prompt. 

You will get at the end of the process the following lines:
<pre>
0 Error(s)

Time Elapsed 00:00:00.32
..\src\IceChat\bin\Debug\IceChat2009.exe
1 File(s) copied
..\src\IceChat\\bin\Debug\IPluginIceChat.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IRCConnection.dll
1 File(s) copied
..\src\IceChat\\bin\Debug\IThemeIceChat.dll
1 File(s) copied
IceChat files copied to the IceChatBuild folder
Press any key to continue . . .
</pre>

A new folder is created called IceChatBuild, and once the batch file has completed, 4 files will be placed in this folder. 
A log file named <code>Manual_MSBuild_ReleaseVersion_LOG.log</code> is also created.

Copy these 4 files into your IceChat installation folder, or place them anywhere else you want.

To see all the changes from build to build, read the changelog.txt file in the root folder.
==Troubleshooting==

If the BuildIceChat.cmd returns errors, try instead to run the newer IceChatBuild.4.5.cmd which was specifically created for users who have errors with IceChatBuild.cmd.


If you experience problems connecting to servers with SSL, try build with IceChatBuild.4.5.cmd

==Sources==
Get Microsoft .NET Framework 4.5.2 at [https://www.microsoft.com/en-ca/download/details.aspx?id=42642 this] link.
[[Category:IceChat 9]]
[[Category:Initial]]
[[Category:Advance Usage]]
[[Category:Linux]]

IceChat on Linux

2017-07-29T18:25:22Z

IceCold: IceChat runs under mono

Inorder to run IceChat 9 runs on Linux follow these steps:

== IceChat 9 ==
<ol>
<li>Install the mono package.</li>
<li>Get the Icechat source from [https://github.com/icechat/ github]</li>

<li>Extract the zip content under some folder for running. 
Let's assume it is placed under the home folder as follows:
<code>~/IceChat9-source/</code></li>
<li>Open the terminal in the <code>build</code> sub-folder of the source </li>
<li>run the following: 
<code> [user@userHost build]$ sh BuildIceChatLinux.sh </code> 
Long build messages are displayed. At the end you should see the following messages: 
<pre>Build succeeded.
0 Warning(s)
0 Error(s)

Time Elapsed 00:00:14.4694500
Completed! Files copied to the IceChatBuild folder</pre>
The <code>build</code> folder now contains a new sub folder named <code>IceChatBuild </code>
</li>
<li>Copy / rename that sub-folder to anywhere you want IceChat, for example, as <code>~/IceChat9 </code> </li>
<li>Run the following command in a terminal 
<code>[user@userHost IceChat9]$ mono IceChat2009.exe</code>
</li>
<li>Icechat 9 will run, and create its data folder under <code>~/.local/share/IceChat Networks/IceChat/ </code> 
If you like the Data folder someplace else, use the following command: 
<code>[user@userHost IceChat9]$ mono IceChat2009.exe -profile [path/dataFolderName]</code> 
For example: 
<code>[user@userHost IceChat9]$ mono IceChat2009.exe -profile myProfile</code> 
will create a data folder named myProfile under the IceChat9 folder.

</li>
</ol>

When IceChat runs for the first time, it offers to import setting from its predecessor, IceChat 7. See [[Install_IceChat_9#First_Run| First Run]] for details.

== Notes ==
At the moment, there are some networks that cannot be connected with [[New_Server#Main_Settings_tab_2|SSL]]. this is being worked on, and will be updated when fixed. 

A desktop shortcut can be created for the command line above to be placed on a panel or anywhere else 
Following is an example of <code>IceChat9.desktop</code> 
<pre>
[Desktop Entry]
Version=1.0
Type=Application
Name=IceChat9
Comment=The Chat Cool People Use
Exec=mono /home/user/IceChat9/IceChat2009.exe
Icon=IceChat.png
Path=
Terminal=false
StartupNotify=false
</pre>
The IceChat 9 icon can be copied from the source tree in '''(''TBD'')''' 

<cite>The above was tested with [https://manjaro.org/ Manjaro] distro in July 2017, with mono version 5.0.0</cite>

[[Category:Linux]]
[[Category:IceChat 9]]
[[Category:Advance Usage]]

Plugins

2017-07-29T16:55:16Z

IceCold: update links and add several plugins

IceChat plugins are a way to enhance the client functionality. 
The [https://github.com/icechat/IceChat/ source code] has a Plugin folder, with a Blank Plugin template to work from.

All installed plugins must be placed in a Plugins subfolder under the installation folder (which by default is located in ([https://en.wikipedia.org/wiki/Environment_variable#Default_values %ProgramFiles%]\IceChat9)

The Plugins Folder can be opened from the Browse Plugins Folder under the Help menu.

Initially, IceChat comes with an optional Highlite plugin. Several others are available for download on the IceChat 9 Plugins of the site's [http://www.icechat.net/site/downloads/download.php?category=4 download] page, each listed below.

== Google Plugin ==
This plugin performs a Google search.

Type <code>!google</code> in the [[Layout#Default Layout|Input Line]], followed by the desired search string. 
Several (usually 5) top results will be displayed on the current tab.

== High lite Plugin ==
This plugin highlights user defined words on a channel window. 
It's settings tab is part of the [[Colors]] settings of IceChat and explained [[Colors#High Lite tab|there]].

== Nick High Lite Plugin ==
Similar to the High lite Plugin, this plugin highlights nick names on the [[Layout#Default_Layout|Nick List]] window. 
It's settings tab is part of the [[Colors]] settings of IceChat and explained [[Colors#Nick Hilite tab|there]].

== Simple Script Plugin ==
This plugin allows the user to define some commands in response to events. 

To add or edit a command, open the IceChat Editor from the Tool Bar or the Options menu entry, or by the key shortcut <code>CTRL+S</code>.

The Simple Script tab lists all the existing commands. Each command can be temporarily disabled by un-checking its checkbox.

[[File:ice9-simpleScript.jpg|512px]]

Each command is edited in the Script Item window.

[[File:ice9-simple-script-item.jpg]]

The example in the screenshot is designed to help erroneous join statement in #IceChat channel. 
If a user type <code>join #channel</code> (without '/') in #IceChat channel, the following message will be displayed: 
<code>To join a channel, type /join #channel</code> 

<dl>
<dt>Script event </dt>
<dd>Choose the required event from a list. The command will be triggered when this event occurs. </dd>

<dt>Text to match </dt>
<dd>Type the text that will trigger this specific command. The text can be a [https://en.wikipedia.org/wiki/Regular_expression regular expression], as in the above [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx#character_classes example]. </dd>

<dt>Channel/ Nick match </dt>
<dd>where would the command be performed. In the above example, the command will only be displayed in #IceChat channel. 
In case of a nick, the command will be displayed in response to that nick only.</dd>

<dt>Command to run </dt>
<dd>Any IRC command can be used and it can include IceChat Identifiers listed on the [[Identifiers]] page or the [[Colors#Messages tab|Colors' Messages]] page. </dd>

</dl>

== Twitter Plugin ==
The Twitter plugin display tweets from the users listed for it, in colors to differentiate between the accounts. 
To set users to be displayed, open the [[Settings]] window of IceChat from the Tool Bar or the Options menu entry, or by the key shortcut <code>CTRL+P</code>.

[[File:ice9-twitter-settings.jpg|512px]]

The tweets can be displayed on a single @Twitter tab, or on a separate @<user name> tab for each user.

== Buzzen Plugin ==
This plugin connects a user to the Buzzen chat network.
The first time this plugin is used, IceChat requests the email address registered with Buzzen, and the password.

These are sent to the server for authentication, during connection.
== Channel Monitor ==
Using this plugin you can see messages from various channels in a single window. 

[[File:Ice9-Channel-Monitor.jpg|800px]]

The plugin's effect can be switched on or off by right-clicking on the Server Tree channel, and checking / un-checking it.

=== Toubleshouting ===
If, for some reason you cannot see the plugin's window under the status bar, try the following:
<ol>
<li>Make sure the plugin's dll is located in the Plugins folder (see above) </li>
<li>Check that the plugin is enabled in the Options -> Loaded Plugins -> Channel Monitor (under the main menu) </li>
<li>If the plugin is enabled, and still no window is displayed, disable the plugin and then re-enable it</li>
</ol>

[[File:Ice9-Channel-Monitor-window.jpg]]

== Decide Plugin ==
This plugins returns a random string from the several provided strings. 
Syntax: 
<code>!decide string 1,string 2,string 3 </code>,..... 
Each time the command will return one of the strings randomally.

== Bible Plugin ==
This plugin returns a quote of a requested verse. 
Syntax: 
<code>!bible [book name] [chapter:verse] </code> 

Example: 
<code>!bible Proverbs 18:21</code> 
Result: 
<code>Death and life are in the power of the tongue, and those who love its use will eat its fruit </code> 

<cite>IceChat results are from the [https://bible.org/ bible.org] site</cite>

[[Category:IceChat 9]]
[[Category:Common Usage]]
[[Category:Advance Usage]]
[[Category:Settings]]
[[Category:Scripts]]
[[Category:IceChat Editor]]

File:Ice9-Channel-Monitor-window.jpg

2017-07-29T16:39:22Z

IceCold:

File:Ice9-Channel-Monitor.jpg

2017-07-29T16:31:59Z

IceCold:

Colors

2017-07-28T18:20:06Z

IceCold: some re-wording of the messages tab, for users who come from the "Customizing Messages" link

The Color settings tabs include several basic tabs and several additional tabs that only exist if certain [[plugins]] are installed.

[[File:ice9-colors.jpg|512px]]

== Colors Palette ==
At the bottom of the Color settings window there's a palette of 72 colors that are used everywhere in the software. 
Colors are identified by codes. These are numbers between 0 and 71 representing the ordinal place of a color on the palette.
 
The definition of the palette colors is located in the <code>[[Data Folder#XML_files|ColorPalette.xml]]</code> file under the [[Data Folder]]. If you want to change a certain color to another, replace the existing [http://html-color-codes.info/ Hex code] with one of your own, then re-start IceChat 9.

== Themes tab ==
IceChat 9 comes with several basic themes, which are saved under the [[Data Folder]]. Themes can be added, removed and re-added to IceChat 9 from this tab. 
Each theme is combined of two <code>xml</code> files, using the theme name. One is called <code>Colors-<theme name></code> and the other <code>Messages-<theme name></code>.
So the Blue theme will use these two files: <code>Colors-Blue.xml</code> and <code>Messages-Blue.xml</code>.

If you have used [[:Category:IceChat 7|IceChat 7]] and have themes there that you want to use, they can be imported from this tab. Simply point to IceChat 7 Data Folder, and press the Import IceChat 7 themes. Once imported, the themes are listed in the themes list and can be chosen.

If you have made changes to colors in the various tabs on this window, and you want to keep them, you can save them as a new theme. Press the Add new theme button, give the new theme a name, and it will be added to the themes list, and can be retrieved later at any time.

The Remove theme is used to remove a theme from the themes list. If the removed theme is the one currently used, then the default one will be restored and used the next time IceChat 9 is opened.

A previously removed theme can be loaded again into the themes list by using the Load Theme.

== Messages tab ==
The Messages tab on the [[Colors]] settings (see above) allows the user to change the colors and formatting of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: Basic, which is opened by default, and Advanced, which is the tab to the right of the Basic.

The Advanced tab allows detailed control of parts of a single message/ action, while the Basic allows only a single color for a single message/ action.

Both provide the same set of messages/ actions to be defined.
Messages and actions are divided into several groups in the list for convinience:
<ul>
<li>Channel Messages</li>
<li>Server Messages</li>
<li>Private Messages</li>
<li>Self Messages</li>
<li>[https://en.wikipedia.org/wiki/Client-to-client_protocol CTCP] Messages</li>
<li>[[Settings#DCC_tab|DCC]] Messages</li>
<li>Other Messages</li>
</ul>
=== Basic ===
When you want to change the color of a certain message, select that message from the list, then select a color from the palette. A preview of the message is displayed in the Formatted message preview line.

If you want to change the message background, check the Change background color checkbox (to the left of the Formatted message title) and select a color.

Press Apply to save the changes so far, and go on to make more changes. When you have finished making changes, Save them and leave the Color Settings window.

The Reset to default button restores the original color settings of the message currently selected.

=== Advanced ===
A message is combined of several parts, each can have its own color and background color. These parts are a combination of Identifiers and, for some messages, constant text. 

Each part of a message can have a specific combination of foreground and optionally background colors, starting with a <code>CTRL+K</code> symbol, and ending with that same symbol.

To the right of the messages list on this tab, there a small rectangle with a dynamic legends of the Identifiers that can be used for that message.

==== Identifiers ====
<dl>
<dt>$message</dt>
<dd>This is the text that is relevant to the currently selected message. In case of a Channel Notice this will be the notice sent, in case of an Private Action this will be the action text, and in case of a Self Message this will be the message text. </dd>

<dt>$server</dt>
<dd>The actual server name (as oppose to the network name)</dd>

<dt>$serverip</dt>
<dd>The server IP Address</dd>

<dt>$port</dt>
<dd>The server port</dd>

<dt>$nick</dt>
<dd>This is the nickname that is relevant for the specific type of message or action currently selected. In case of an Channel Invite, that will be the nick who made the invite. In case of a Self Message that will be your own nick.</dd>

<dt>$host</dt>
<dd>The hostname of the $nick</dd>

<dt>$channel</dt>
<dd>The channel name that is relevant to this specific message. In an Channel Invite, this will be the channel to which you are invited. In a Chage Topic message, this will be the channel to which the change of the topic is made.</dd>

<dt>$status</dt>
<dd>The [[Colors#rank|rank*]] of the $nick in that channel.</dd>

<dt>$color</dt>
<dd>This is the color of the $nick's [[Colors#rank|rank*]] in the [[Colors#Nick List tab|Nick List tab]].</dd>

<dt>$account</dt>
<dd>The account name of a user, if that user connects with [[New_Server|SASL]]. TBV </dd>

<dt>$kickee</dt>
<dd>The nick who was kicked</dd>

<dt>$kicker</dt>
<dd>The nick who performed the kick</dd>

<dt>$reason</dt>
<dd>The reason for an Action, such as kick or quit.</dd>

<dt>$mode</dt>
<dd>The channel mode that changed</dd>

<dt>$modeparam</dt>
<dd>The parameters for the changed $mode. For example, +Voice, -Voice, etc.</dd>

<dt>$newnick</dt>
<dd>The new nick name when a nick is changed.</dd>

<dt>$data</dt>
<dd>The whois information</dd>

<dt>$ctcp</dt>
<dd>The Ctcp you wish to request for</dd>

<dt>$file</dt>
<dd>The name of the file trying to be sent</dd>

<dt>$filesize</dt>
<dd>The size in bytes of $file</dd>

</dl>

==== Message Coloring and Formatting ====

Following is an example for a Channel message format, with detailed explanation.

[[File:ice9-channel-message-color-settings.jpg]]

To change the colors of a Channel Message, select it in the upper list of messages. 
In the Edit message here you can see the current setting of that message, and in the Formatted message below, is the preview of the settings. The Legend on the right list the <code>$color, $status, $nick, $message, $host, $channel</code> Identifiers as valid for this message.

Place the cursor to the left of $message (#4 in the screenshot) and open the Color Picker. Select the Yellow color. A symbol followed by the number 08 is displayed (#2 in the screenshot). Next, for the backgound of this part, type a comma, and then select the Blue color (first on the 2nd line of the palette). A symbol followed by the number 12 is displayed (#3 in the screenshot). Remove the symbol, leaving the number 12 near the comma with no spaces between. The result is displayed on the preview line bellow (#6 in the screenshot). 

You can manually type the color codes using <code>CTRL+K</code> to create the symbol followed by the desired color code number.

A note on the <code>$color$status$nick</code> combination in the example screenshot:

The <code>$color</code>, is the one that paints this part in Dark Blue (#7 in the screenshot). In live channels, this will show each nick name painted with the color of its [[Colors#rank|rank*]] from the [[Colors#Nick List tab|Nick List]].
The <code>$status</code> Identifier will display in live channels the [[Colors#rank|rank*]] (if exists) of the nick who wrote the message.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message.jpg]]

If you want to change the way a message is formatted, you may add the format on this same line: 

[[File:ice9-channel-message-format-settings.jpg]]

Note the square brackets and semicolon instead of the default setting.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message-formatted.jpg]]

== Server tree/Tabs tab ==
This tab handles the colors of events and messages on the [[Layout#Server_Tree|Server Tree]].
The left side of the tab handles the foreground colors and the right side defines the background colors.

=== Foreground colors ===

<dl>
<dt>Current tab</dt>
<dd>Affect the text color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>New Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new message on the channel. </dd>

<dt>New Action</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new action on the channel. </dd>

<dt>Channel Join</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone joins a channel. </dd>

<dt>Channel Part</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone parts a channel. </dd>

<dt>Server Quit</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone disconnected from the server. </dd>

<dt>Server Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some message. </dd>

<dt>Server Notice</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some notice. </dd>

<dt>Buddy List</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when a [[Layout#Buddy_List|buddy]] comes on line or disconnects. </dd>

<dt>Other</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] for messages other then the ones listed above. </dd>

<dt>Default</dt>
<dd>This is the default color of the text on the [[Layout#Server_Tree|Server Tree]]. Server names and opened channels will have this color when there are no other events that trigger the above defined colors. </dd>
</dl>

=== Background colors ===
Setting different colors for Color 1 and Color 2 for elements creates gradient effect.

<dl>
<dt>Current Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Default Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the tabs other then the current on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Hover Tab - Color 1/ Color 2</dt>
<dd>This is the color displayed when hovering over a tab other then the current on the [[Layout#Default_Layout|Channel Bar]]. </dd>

<dt>Background</dt>
<dd>The background of the [[Layout#Default_Layout|Channel Bar]]. </dd>
</dl>

== Nick List tab ==
This tab handles the color settings for the different user [[Colors#rank|ranks*]]. Thse colors will be displayed on the [[Layout#Buddy_List|Buddy List]] window. It is also set by default for the [[Colors#Messages_tab|Channel Messages]].

== Other tab ==
This tab handles colors of the software elements (as oppose to IRC elements in other tabs).

=== Background colors ===
<dl>
<dt>Console </dt>
<dd>The background of the [[Layout#Welcome_tab|Console]] tabs. This includes the [[Layout#Welcome_tab|Welcome tab]] and each of the server tabs.</dd>

<dt>Channel </dt>
<dd>The background of the [[Layout#Default_Layout|channel]] tabs. </dd>

<dt>Query/ DCC Chat </dt>
<dd>The background of the tabs which are opened for a private communication: query and DCC chat. </dd>

<dt>Nick List </dt>
<dd>The background of the [[Layout#Nick_List|Nick List]] window. </dd>

<dt>Server List </dt>
<dd>The background of the [[Layout#Server_Tree|Server Tree]] window. </dd>

<dt>Channel List </dt>
<dd>The background of the [[Layout#Favorite_Channels|Favorite Channels]] window. </dd>

<dt>Input Box </dt>
<dd>The background of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Side Panel Header - Color 1/ Color 2 </dt>
<dd>The background of the [[Layout#Default_Layout|side windows headers]] and the [[Layout#Default_Layout|buttons on the lower part of the side windows]]. A different Color 1 and Color 2 creates a gradient effect.</dd>

<dt>Menu Bar </dt>
<dd>The background of the Main Menu.</dd>

<dt>Tool Bar </dt>
<dd>The background of the Tool Bar.</dd>

<dt>Status Bar </dt>
<dd>The background of the [[Layout#Default_Layout|Status Bar]].</dd>

</dl>

=== Foreground colors ===
<dl>
<dt>Favorite Channel List </dt>
<dd> </dd>

<dt>Side Panel Header </dt>
<dd>The text color of the [[Layout#Default_Layout|side windows headers]]. </dd>

<dt>Unread text marker </dt>
<dd>Sets the color for the [[Settings#Display_tab|unread text marker]] </dd>

<dt>Status Bar </dt>
<dd>The text of the [[Layout#Default_Layout|Status Bar]].</dd>

<dt>Input Box </dt>
<dd>The text of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Hyperlink </dt>
<dd>The color of hyperlinks on the text windows </dd>

</dl>

== High Lite tab ==
This tab only appears if the [[Plugins#High_lite_Plugin|High lite plugin]] is installed. It sets the options for that plugin.

When setting the options for a text to be highlighted, the following elemets are available:
<dl>
<dt>Text to highlight </dt>
<dd>Any string added here, will be highlighted on channels when mentioned. The text can be displayed in color. To set a color for the highlighted text, select one of the colors from the palette in the lower part of the tab. [https://en.wikipedia.org/wiki/Regular_expression regular expression] patterns can be used according to [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx Microsoft examples]. 
If you want to highlight your own nick when mentioned on channels, you can use the Identifier <code>$me</code>.
</dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Sound to play </dt>
<dd>Any supported [[Settings#Sounds_tab|sound file]] from anywhere on your hard disk can be added. </dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Highlight only for selected nicks </dt>
<dd>The text will be highlighted only if it was typed by the nicks listed in this line. Several nick names can be listed, separated by a space. </dd>

<dt>Highlight for all, except selected nicks </dt>
<dd>Opposite in meaning to the above: The text here will not be highlighted if it was typed by any of the nick names in this list. Several nick names can be listed, separated by a space.</dd>

<dt>Flash channel tab on highlight </dt>
<dd>If the client is not minimized to the [[Settings#Main_Settings_tab|System Tray]] </dd>

</dl>

== Nick Hilite tab ==
This tab only appears if the [[Plugins#Nick_High_Lite_Plugin|Nick Hilite plugin]] is installed. It sets the options for that plugin.

<dl>
<dt>Nick to highlight </dt>
<dd>Type a nick name, and select a color from the palette at the bottom of the tab. The nick name will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

<dt>Host to highlight </dt>
<dd>If populated, that host or any host that the text is part of, will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

</dl>

<div id="rank">rank* - a local terminology representing a subset of [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Modes user modes] on channel, such as Voice, Op, Half Op, etc. The ranks are listed on the [[Colors#Nick List tab|Nick List tab]]. </div>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:UI]]
[[Category:Common Usage]]
[[Category:Advance Usage]]
[[Category:Customizing Messages]]

Customize Messages

2017-07-28T18:07:33Z

IceCold: IceCold moved page Messages to Customize Messages: rename the page

#REDIRECT [[Colors#Messages_tab|Customizing Messages]]
[[Category:Customizing Messages]]
[[Category:IceChat 9]]

Messages

2017-07-28T18:07:33Z

IceCold: IceCold moved page Messages to Customize Messages: rename the page

#REDIRECT [[Customize Messages]]

IceChat on Linux

2017-07-28T18:04:32Z

IceCold: add Page to category IceChat 9

IceChat 9 works only partially on Linux.

The following describes what works and under which conditions.

== IceChat 9 ==
<ol>
<li>Install the mono package.</li>
<li>Get the icechat-portable-4.5.zip from [https://github.com/icechat/IceChat/releases github]</li>

<li>Extract the zip content under some folder for running. 
Let's assume it is placed under the home folder as follows:
<code>~/IceChat9/</code></li>
</ol>
you can now run the following command in the command line: 
<code>mono ~/IceChat9/IceChat2009.exe -profile [pathToProfile/profileName]</code> 
Example: 
<code>mono ~/IceChat9/IceChat2009.exe -profile data</code> 
In the above example, a profile will be created inside the IceChat folder under the <code>data</code> folder.

When IceChat runs for the first time, it offers to import setting from its predecessor, IceChat 7. See [http://wiki.icechat.net/index.php?title=Install_IceChat_9#First_Run First Run] for details.

== Notes ==
There are several issues with running IceChat 9 under Linux: 
The [[Layout#Windowed_Layout|Windowed mode]] does not work, only Tabbed mode is available.

Some sites do not connect with [[New_Server#Main_Settings_tab|SSL]] set on. This is being worked on, and will be updated as soon as the problem is fixed.

IceChat 9 does not work under wine. 
For IceChat 9 to work under wine, the following packages are required to be installed:
<ul>
<li>wine</li>
<li>wine-mono</li>
<li>wine-gecko</li>
</ul>

Then, simply use the IceChat icon which is created on the desktop.
However, there's some problem and wine does not run IceChat.

<cite>The above was tested with [https://manjaro.org/ Manjaro] distro in July 2017. The mono package version is 5.0.0 and wine-mono version is 4.7.0</cite>

[[Category:Linux]]
[[Category:IceChat 9]]

Customize Messages

2017-07-28T18:03:52Z

IceCold: add Page to category IceChat 9

#REDIRECT [[Colors#Messages_tab|Customizing Messages]]
[[Category:Customizing Messages]]
[[Category:IceChat 9]]

IceChat on Linux

2017-07-28T17:59:19Z

IceCold: add Page to category Linux

Category:Customizing Messages

2017-07-28T17:51:52Z

IceCold:

This category lists the places that explain how to customize the colors or format of IceChat messages.

Category:Customizing Messages

2017-07-28T17:47:20Z

IceCold: Added category page

This category list the places that explain how to customize the colors or format of IceChat messages.

Colors

2017-07-28T17:34:36Z

IceCold: add the Colors page to "Customizing Messages " category

The Color settings tabs include several basic tabs and several additional tabs that only exist if certain [[plugins]] are installed.

[[File:ice9-colors.jpg|512px]]

== Colors Palette ==
At the bottom of the Color settings window there's a palette of 72 colors that are used everywhere in the software. 
Colors are identified by codes. These are numbers between 0 and 71 representing the ordinal place of a color on the palette.
 
The definition of the palette colors is located in the <code>[[Data Folder#XML_files|ColorPalette.xml]]</code> file under the [[Data Folder]]. If you want to change a certain color to another, replace the existing [http://html-color-codes.info/ Hex code] with one of your own, then re-start IceChat 9.

== Themes tab ==
IceChat 9 comes with several basic themes, which are saved under the [[Data Folder]]. Themes can be added, removed and re-added to IceChat 9 from this tab. 
Each theme is combined of two <code>xml</code> files, using the theme name. One is called <code>Colors-<theme name></code> and the other <code>Messages-<theme name></code>.
So the Blue theme will use these two files: <code>Colors-Blue.xml</code> and <code>Messages-Blue.xml</code>.

If you have used [[:Category:IceChat 7|IceChat 7]] and have themes there that you want to use, they can be imported from this tab. Simply point to IceChat 7 Data Folder, and press the Import IceChat 7 themes. Once imported, the themes are listed in the themes list and can be chosen.

If you have made changes to colors in the various tabs on this window, and you want to keep them, you can save them as a new theme. Press the Add new theme button, give the new theme a name, and it will be added to the themes list, and can be retrieved later at any time.

The Remove theme is used to remove a theme from the themes list. If the removed theme is the one currently used, then the default one will be restored and used the next time IceChat 9 is opened.

A previously removed theme can be loaded again into the themes list by using the Load Theme.

== Messages tab ==
This tab handles the colors of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: Basic, which is opened by default, and Advanced, which is the tab to the right of the Basic.

The Advanced tab allows detailed control of parts of a single message/ action, while the Basic allows only a single color for a single message/ action.

Both provide the same set of messages/ actions to be defined.
Messages and actions are divided into several groups in the list for convinience:
<ul>
<li>Channel Messages</li>
<li>Server Messages</li>
<li>Private Messages</li>
<li>Self Messages</li>
<li>[https://en.wikipedia.org/wiki/Client-to-client_protocol CTCP] Messages</li>
<li>[[Settings#DCC_tab|DCC]] Messages</li>
<li>Other Messages</li>
</ul>
=== Basic ===
When you want to change the color of a certain message, select that message from the list, then select a color from the palette. A preview of the message is displayed in the Formatted message preview line.

If you want to change the message background, check the Change background color checkbox (to the left of the Formatted message title) and select a color.

Press Apply to save the changes so far, and go on to make more changes. When you have finished making changes, Save them and leave the Color Settings window.

The Reset to default button restores the original color settings of the message currently selected.

=== Advanced ===
A message is combined of several parts, each can have its own color and background color. These parts are a combination of Identifiers and, for some messages, constant text. 

Each part of a message can have a specific combination of foreground and optionally background colors, starting with a <code>CTRL+K</code> symbol, and ending with that same symbol.

To the right of the messages list on this tab, there a small rectangle with a dynamic legends of the Identifiers that can be used for that message.

==== Identifiers ====
<dl>
<dt>$message</dt>
<dd>This is the text that is relevant to the currently selected message. In case of a Channel Notice this will be the notice sent, in case of an Private Action this will be the action text, and in case of a Self Message this will be the message text. </dd>

<dt>$server</dt>
<dd>The actual server name (as oppose to the network name)</dd>

<dt>$serverip</dt>
<dd>The server IP Address</dd>

<dt>$port</dt>
<dd>The server port</dd>

<dt>$nick</dt>
<dd>This is the nickname that is relevant for the specific type of message or action currently selected. In case of an Channel Invite, that will be the nick who made the invite. In case of a Self Message that will be your own nick.</dd>

<dt>$host</dt>
<dd>The hostname of the $nick</dd>

<dt>$channel</dt>
<dd>The channel name that is relevant to this specific message. In an Channel Invite, this will be the channel to which you are invited. In a Chage Topic message, this will be the channel to which the change of the topic is made.</dd>

<dt>$status</dt>
<dd>The [[Colors#rank|rank*]] of the $nick in that channel.</dd>

<dt>$color</dt>
<dd>This is the color of the $nick's [[Colors#rank|rank*]] in the [[Colors#Nick List tab|Nick List tab]].</dd>

<dt>$account</dt>
<dd>The account name of a user, if that user connects with [[New_Server|SASL]]. TBV </dd>

<dt>$kickee</dt>
<dd>The nick who was kicked</dd>

<dt>$kicker</dt>
<dd>The nick who performed the kick</dd>

<dt>$reason</dt>
<dd>The reason for an Action, such as kick or quit.</dd>

<dt>$mode</dt>
<dd>The channel mode that changed</dd>

<dt>$modeparam</dt>
<dd>The parameters for the changed $mode. For example, +Voice, -Voice, etc.</dd>

<dt>$newnick</dt>
<dd>The new nick name when a nick is changed.</dd>

<dt>$data</dt>
<dd>The whois information</dd>

<dt>$ctcp</dt>
<dd>The Ctcp you wish to request for</dd>

<dt>$file</dt>
<dd>The name of the file trying to be sent</dd>

<dt>$filesize</dt>
<dd>The size in bytes of $file</dd>

</dl>

==== Message Coloring and Formatting ====

Following is an example for a Channel message format, with detailed explanation.

[[File:ice9-channel-message-color-settings.jpg]]

To change the colors of a Channel Message, select it in the upper list of messages. 
In the Edit message here you can see the current setting of that message, and in the Formatted message below, is the preview of the settings. The Legend on the right list the <code>$color, $status, $nick, $message, $host, $channel</code> Identifiers as valid for this message.

Place the cursor to the left of $message (#4 in the screenshot) and open the Color Picker. Select the Yellow color. A symbol followed by the number 08 is displayed (#2 in the screenshot). Next, for the backgound of this part, type a comma, and then select the Blue color (first on the 2nd line of the palette). A symbol followed by the number 12 is displayed (#3 in the screenshot). Remove the symbol, leaving the number 12 near the comma with no spaces between. The result is displayed on the preview line bellow (#6 in the screenshot). 

You can manually type the color codes using <code>CTRL+K</code> to create the symbol followed by the desired color code number.

A note on the <code>$color$status$nick</code> combination in the example screenshot:

The <code>$color</code>, is the one that paints this part in Dark Blue (#7 in the screenshot). In live channels, this will show each nick name painted with the color of its [[Colors#rank|rank*]] from the [[Colors#Nick List tab|Nick List]].
The <code>$status</code> Identifier will display in live channels the [[Colors#rank|rank*]] (if exists) of the nick who wrote the message.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message.jpg]]

If you want to change the way a message is formatted, you may add the format on this same line: 

[[File:ice9-channel-message-format-settings.jpg]]

Note the square brackets and semicolon instead of the default setting.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message-formatted.jpg]]

== Server tree/Tabs tab ==
This tab handles the colors of events and messages on the [[Layout#Server_Tree|Server Tree]].
The left side of the tab handles the foreground colors and the right side defines the background colors.

=== Foreground colors ===

<dl>
<dt>Current tab</dt>
<dd>Affect the text color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>New Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new message on the channel. </dd>

<dt>New Action</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new action on the channel. </dd>

<dt>Channel Join</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone joins a channel. </dd>

<dt>Channel Part</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone parts a channel. </dd>

<dt>Server Quit</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone disconnected from the server. </dd>

<dt>Server Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some message. </dd>

<dt>Server Notice</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some notice. </dd>

<dt>Buddy List</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when a [[Layout#Buddy_List|buddy]] comes on line or disconnects. </dd>

<dt>Other</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] for messages other then the ones listed above. </dd>

<dt>Default</dt>
<dd>This is the default color of the text on the [[Layout#Server_Tree|Server Tree]]. Server names and opened channels will have this color when there are no other events that trigger the above defined colors. </dd>
</dl>

=== Background colors ===
Setting different colors for Color 1 and Color 2 for elements creates gradient effect.

<dl>
<dt>Current Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Default Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the tabs other then the current on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Hover Tab - Color 1/ Color 2</dt>
<dd>This is the color displayed when hovering over a tab other then the current on the [[Layout#Default_Layout|Channel Bar]]. </dd>

<dt>Background</dt>
<dd>The background of the [[Layout#Default_Layout|Channel Bar]]. </dd>
</dl>

== Nick List tab ==
This tab handles the color settings for the different user [[Colors#rank|ranks*]]. Thse colors will be displayed on the [[Layout#Buddy_List|Buddy List]] window. It is also set by default for the [[Colors#Messages_tab|Channel Messages]].

== Other tab ==
This tab handles colors of the software elements (as oppose to IRC elements in other tabs).

=== Background colors ===
<dl>
<dt>Console </dt>
<dd>The background of the [[Layout#Welcome_tab|Console]] tabs. This includes the [[Layout#Welcome_tab|Welcome tab]] and each of the server tabs.</dd>

<dt>Channel </dt>
<dd>The background of the [[Layout#Default_Layout|channel]] tabs. </dd>

<dt>Query/ DCC Chat </dt>
<dd>The background of the tabs which are opened for a private communication: query and DCC chat. </dd>

<dt>Nick List </dt>
<dd>The background of the [[Layout#Nick_List|Nick List]] window. </dd>

<dt>Server List </dt>
<dd>The background of the [[Layout#Server_Tree|Server Tree]] window. </dd>

<dt>Channel List </dt>
<dd>The background of the [[Layout#Favorite_Channels|Favorite Channels]] window. </dd>

<dt>Input Box </dt>
<dd>The background of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Side Panel Header - Color 1/ Color 2 </dt>
<dd>The background of the [[Layout#Default_Layout|side windows headers]] and the [[Layout#Default_Layout|buttons on the lower part of the side windows]]. A different Color 1 and Color 2 creates a gradient effect.</dd>

<dt>Menu Bar </dt>
<dd>The background of the Main Menu.</dd>

<dt>Tool Bar </dt>
<dd>The background of the Tool Bar.</dd>

<dt>Status Bar </dt>
<dd>The background of the [[Layout#Default_Layout|Status Bar]].</dd>

</dl>

=== Foreground colors ===
<dl>
<dt>Favorite Channel List </dt>
<dd> </dd>

<dt>Side Panel Header </dt>
<dd>The text color of the [[Layout#Default_Layout|side windows headers]]. </dd>

<dt>Unread text marker </dt>
<dd>Sets the color for the [[Settings#Display_tab|unread text marker]] </dd>

<dt>Status Bar </dt>
<dd>The text of the [[Layout#Default_Layout|Status Bar]].</dd>

<dt>Input Box </dt>
<dd>The text of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Hyperlink </dt>
<dd>The color of hyperlinks on the text windows </dd>

</dl>

== High Lite tab ==
This tab only appears if the [[Plugins#High_lite_Plugin|High lite plugin]] is installed. It sets the options for that plugin.

When setting the options for a text to be highlighted, the following elemets are available:
<dl>
<dt>Text to highlight </dt>
<dd>Any string added here, will be highlighted on channels when mentioned. The text can be displayed in color. To set a color for the highlighted text, select one of the colors from the palette in the lower part of the tab. [https://en.wikipedia.org/wiki/Regular_expression regular expression] patterns can be used according to [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx Microsoft examples]. 
If you want to highlight your own nick when mentioned on channels, you can use the Identifier <code>$me</code>.
</dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Sound to play </dt>
<dd>Any supported [[Settings#Sounds_tab|sound file]] from anywhere on your hard disk can be added. </dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Highlight only for selected nicks </dt>
<dd>The text will be highlighted only if it was typed by the nicks listed in this line. Several nick names can be listed, separated by a space. </dd>

<dt>Highlight for all, except selected nicks </dt>
<dd>Opposite in meaning to the above: The text here will not be highlighted if it was typed by any of the nick names in this list. Several nick names can be listed, separated by a space.</dd>

<dt>Flash channel tab on highlight </dt>
<dd>If the client is not minimized to the [[Settings#Main_Settings_tab|System Tray]] </dd>

</dl>

== Nick Hilite tab ==
This tab only appears if the [[Plugins#Nick_High_Lite_Plugin|Nick Hilite plugin]] is installed. It sets the options for that plugin.

<dl>
<dt>Nick to highlight </dt>
<dd>Type a nick name, and select a color from the palette at the bottom of the tab. The nick name will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

<dt>Host to highlight </dt>
<dd>If populated, that host or any host that the text is part of, will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

</dl>

<div id="rank">rank* - a local terminology representing a subset of [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Modes user modes] on channel, such as Voice, Op, Half Op, etc. The ranks are listed on the [[Colors#Nick List tab|Nick List tab]]. </div>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:UI]]
[[Category:Common Usage]]
[[Category:Advance Usage]]
[[Category:Customizing Messages]]

Customize Messages

2017-07-28T17:27:48Z

IceCold: Redirected page to Colors#Messages tab

#REDIRECT [[Colors#Messages_tab|Customizing Messages]]
[[Category:Customizing Messages]]

Customize Messages

2017-07-28T17:20:19Z

IceCold: add a category for the messages colors and formatting header

#REDIRECT [[Colors|Messages_tab]]
[[Category:Customizing Messages]]

Colors

2017-07-28T16:01:01Z

IceCold: added message formatting paragraph

The Color settings tabs include several basic tabs and several additional tabs that only exist if certain [[plugins]] are installed.

[[File:ice9-colors.jpg|512px]]

== Colors Palette ==
At the bottom of the Color settings window there's a palette of 72 colors that are used everywhere in the software. 
Colors are identified by codes. These are numbers between 0 and 71 representing the ordinal place of a color on the palette.
 
The definition of the palette colors is located in the <code>[[Data Folder#XML_files|ColorPalette.xml]]</code> file under the [[Data Folder]]. If you want to change a certain color to another, replace the existing [http://html-color-codes.info/ Hex code] with one of your own, then re-start IceChat 9.

== Themes tab ==
IceChat 9 comes with several basic themes, which are saved under the [[Data Folder]]. Themes can be added, removed and re-added to IceChat 9 from this tab. 
Each theme is combined of two <code>xml</code> files, using the theme name. One is called <code>Colors-<theme name></code> and the other <code>Messages-<theme name></code>.
So the Blue theme will use these two files: <code>Colors-Blue.xml</code> and <code>Messages-Blue.xml</code>.

If you have used [[:Category:IceChat 7|IceChat 7]] and have themes there that you want to use, they can be imported from this tab. Simply point to IceChat 7 Data Folder, and press the Import IceChat 7 themes. Once imported, the themes are listed in the themes list and can be chosen.

If you have made changes to colors in the various tabs on this window, and you want to keep them, you can save them as a new theme. Press the Add new theme button, give the new theme a name, and it will be added to the themes list, and can be retrieved later at any time.

The Remove theme is used to remove a theme from the themes list. If the removed theme is the one currently used, then the default one will be restored and used the next time IceChat 9 is opened.

A previously removed theme can be loaded again into the themes list by using the Load Theme.

== Messages tab ==
This tab handles the colors of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: Basic, which is opened by default, and Advanced, which is the tab to the right of the Basic.

The Advanced tab allows detailed control of parts of a single message/ action, while the Basic allows only a single color for a single message/ action.

Both provide the same set of messages/ actions to be defined.
Messages and actions are divided into several groups in the list for convinience:
<ul>
<li>Channel Messages</li>
<li>Server Messages</li>
<li>Private Messages</li>
<li>Self Messages</li>
<li>[https://en.wikipedia.org/wiki/Client-to-client_protocol CTCP] Messages</li>
<li>[[Settings#DCC_tab|DCC]] Messages</li>
<li>Other Messages</li>
</ul>
=== Basic ===
When you want to change the color of a certain message, select that message from the list, then select a color from the palette. A preview of the message is displayed in the Formatted message preview line.

If you want to change the message background, check the Change background color checkbox (to the left of the Formatted message title) and select a color.

Press Apply to save the changes so far, and go on to make more changes. When you have finished making changes, Save them and leave the Color Settings window.

The Reset to default button restores the original color settings of the message currently selected.

=== Advanced ===
A message is combined of several parts, each can have its own color and background color. These parts are a combination of Identifiers and, for some messages, constant text. 

Each part of a message can have a specific combination of foreground and optionally background colors, starting with a <code>CTRL+K</code> symbol, and ending with that same symbol.

To the right of the messages list on this tab, there a small rectangle with a dynamic legends of the Identifiers that can be used for that message.

==== Identifiers ====
<dl>
<dt>$message</dt>
<dd>This is the text that is relevant to the currently selected message. In case of a Channel Notice this will be the notice sent, in case of an Private Action this will be the action text, and in case of a Self Message this will be the message text. </dd>

<dt>$server</dt>
<dd>The actual server name (as oppose to the network name)</dd>

<dt>$serverip</dt>
<dd>The server IP Address</dd>

<dt>$port</dt>
<dd>The server port</dd>

<dt>$nick</dt>
<dd>This is the nickname that is relevant for the specific type of message or action currently selected. In case of an Channel Invite, that will be the nick who made the invite. In case of a Self Message that will be your own nick.</dd>

<dt>$host</dt>
<dd>The hostname of the $nick</dd>

<dt>$channel</dt>
<dd>The channel name that is relevant to this specific message. In an Channel Invite, this will be the channel to which you are invited. In a Chage Topic message, this will be the channel to which the change of the topic is made.</dd>

<dt>$status</dt>
<dd>The [[Colors#rank|rank*]] of the $nick in that channel.</dd>

<dt>$color</dt>
<dd>This is the color of the $nick's [[Colors#rank|rank*]] in the [[Colors#Nick List tab|Nick List tab]].</dd>

<dt>$account</dt>
<dd>The account name of a user, if that user connects with [[New_Server|SASL]]. TBV </dd>

<dt>$kickee</dt>
<dd>The nick who was kicked</dd>

<dt>$kicker</dt>
<dd>The nick who performed the kick</dd>

<dt>$reason</dt>
<dd>The reason for an Action, such as kick or quit.</dd>

<dt>$mode</dt>
<dd>The channel mode that changed</dd>

<dt>$modeparam</dt>
<dd>The parameters for the changed $mode. For example, +Voice, -Voice, etc.</dd>

<dt>$newnick</dt>
<dd>The new nick name when a nick is changed.</dd>

<dt>$data</dt>
<dd>The whois information</dd>

<dt>$ctcp</dt>
<dd>The Ctcp you wish to request for</dd>

<dt>$file</dt>
<dd>The name of the file trying to be sent</dd>

<dt>$filesize</dt>
<dd>The size in bytes of $file</dd>

</dl>

==== Message Coloring and Formatting ====

Following is an example for a Channel message format, with detailed explanation.

[[File:ice9-channel-message-color-settings.jpg]]

To change the colors of a Channel Message, select it in the upper list of messages. 
In the Edit message here you can see the current setting of that message, and in the Formatted message below, is the preview of the settings. The Legend on the right list the <code>$color, $status, $nick, $message, $host, $channel</code> Identifiers as valid for this message.

Place the cursor to the left of $message (#4 in the screenshot) and open the Color Picker. Select the Yellow color. A symbol followed by the number 08 is displayed (#2 in the screenshot). Next, for the backgound of this part, type a comma, and then select the Blue color (first on the 2nd line of the palette). A symbol followed by the number 12 is displayed (#3 in the screenshot). Remove the symbol, leaving the number 12 near the comma with no spaces between. The result is displayed on the preview line bellow (#6 in the screenshot). 

You can manually type the color codes using <code>CTRL+K</code> to create the symbol followed by the desired color code number.

A note on the <code>$color$status$nick</code> combination in the example screenshot:

The <code>$color</code>, is the one that paints this part in Dark Blue (#7 in the screenshot). In live channels, this will show each nick name painted with the color of its [[Colors#rank|rank*]] from the [[Colors#Nick List tab|Nick List]].
The <code>$status</code> Identifier will display in live channels the [[Colors#rank|rank*]] (if exists) of the nick who wrote the message.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message.jpg]]

If you want to change the way a message is formatted, you may add the format on this same line: 

[[File:ice9-channel-message-format-settings.jpg]]

Note the square brackets and semicolon instead of the default setting.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message-formatted.jpg]]

== Server tree/Tabs tab ==
This tab handles the colors of events and messages on the [[Layout#Server_Tree|Server Tree]].
The left side of the tab handles the foreground colors and the right side defines the background colors.

=== Foreground colors ===

<dl>
<dt>Current tab</dt>
<dd>Affect the text color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>New Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new message on the channel. </dd>

<dt>New Action</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new action on the channel. </dd>

<dt>Channel Join</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone joins a channel. </dd>

<dt>Channel Part</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone parts a channel. </dd>

<dt>Server Quit</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone disconnected from the server. </dd>

<dt>Server Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some message. </dd>

<dt>Server Notice</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some notice. </dd>

<dt>Buddy List</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when a [[Layout#Buddy_List|buddy]] comes on line or disconnects. </dd>

<dt>Other</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] for messages other then the ones listed above. </dd>

<dt>Default</dt>
<dd>This is the default color of the text on the [[Layout#Server_Tree|Server Tree]]. Server names and opened channels will have this color when there are no other events that trigger the above defined colors. </dd>
</dl>

=== Background colors ===
Setting different colors for Color 1 and Color 2 for elements creates gradient effect.

<dl>
<dt>Current Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Default Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the tabs other then the current on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Hover Tab - Color 1/ Color 2</dt>
<dd>This is the color displayed when hovering over a tab other then the current on the [[Layout#Default_Layout|Channel Bar]]. </dd>

<dt>Background</dt>
<dd>The background of the [[Layout#Default_Layout|Channel Bar]]. </dd>
</dl>

== Nick List tab ==
This tab handles the color settings for the different user [[Colors#rank|ranks*]]. Thse colors will be displayed on the [[Layout#Buddy_List|Buddy List]] window. It is also set by default for the [[Colors#Messages_tab|Channel Messages]].

== Other tab ==
This tab handles colors of the software elements (as oppose to IRC elements in other tabs).

=== Background colors ===
<dl>
<dt>Console </dt>
<dd>The background of the [[Layout#Welcome_tab|Console]] tabs. This includes the [[Layout#Welcome_tab|Welcome tab]] and each of the server tabs.</dd>

<dt>Channel </dt>
<dd>The background of the [[Layout#Default_Layout|channel]] tabs. </dd>

<dt>Query/ DCC Chat </dt>
<dd>The background of the tabs which are opened for a private communication: query and DCC chat. </dd>

<dt>Nick List </dt>
<dd>The background of the [[Layout#Nick_List|Nick List]] window. </dd>

<dt>Server List </dt>
<dd>The background of the [[Layout#Server_Tree|Server Tree]] window. </dd>

<dt>Channel List </dt>
<dd>The background of the [[Layout#Favorite_Channels|Favorite Channels]] window. </dd>

<dt>Input Box </dt>
<dd>The background of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Side Panel Header - Color 1/ Color 2 </dt>
<dd>The background of the [[Layout#Default_Layout|side windows headers]] and the [[Layout#Default_Layout|buttons on the lower part of the side windows]]. A different Color 1 and Color 2 creates a gradient effect.</dd>

<dt>Menu Bar </dt>
<dd>The background of the Main Menu.</dd>

<dt>Tool Bar </dt>
<dd>The background of the Tool Bar.</dd>

<dt>Status Bar </dt>
<dd>The background of the [[Layout#Default_Layout|Status Bar]].</dd>

</dl>

=== Foreground colors ===
<dl>
<dt>Favorite Channel List </dt>
<dd> </dd>

<dt>Side Panel Header </dt>
<dd>The text color of the [[Layout#Default_Layout|side windows headers]]. </dd>

<dt>Unread text marker </dt>
<dd>Sets the color for the [[Settings#Display_tab|unread text marker]] </dd>

<dt>Status Bar </dt>
<dd>The text of the [[Layout#Default_Layout|Status Bar]].</dd>

<dt>Input Box </dt>
<dd>The text of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Hyperlink </dt>
<dd>The color of hyperlinks on the text windows </dd>

</dl>

== High Lite tab ==
This tab only appears if the [[Plugins#High_lite_Plugin|High lite plugin]] is installed. It sets the options for that plugin.

When setting the options for a text to be highlighted, the following elemets are available:
<dl>
<dt>Text to highlight </dt>
<dd>Any string added here, will be highlighted on channels when mentioned. The text can be displayed in color. To set a color for the highlighted text, select one of the colors from the palette in the lower part of the tab. [https://en.wikipedia.org/wiki/Regular_expression regular expression] patterns can be used according to [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx Microsoft examples]. 
If you want to highlight your own nick when mentioned on channels, you can use the Identifier <code>$me</code>.
</dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Sound to play </dt>
<dd>Any supported [[Settings#Sounds_tab|sound file]] from anywhere on your hard disk can be added. </dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Highlight only for selected nicks </dt>
<dd>The text will be highlighted only if it was typed by the nicks listed in this line. Several nick names can be listed, separated by a space. </dd>

<dt>Highlight for all, except selected nicks </dt>
<dd>Opposite in meaning to the above: The text here will not be highlighted if it was typed by any of the nick names in this list. Several nick names can be listed, separated by a space.</dd>

<dt>Flash channel tab on highlight </dt>
<dd>If the client is not minimized to the [[Settings#Main_Settings_tab|System Tray]] </dd>

</dl>

== Nick Hilite tab ==
This tab only appears if the [[Plugins#Nick_High_Lite_Plugin|Nick Hilite plugin]] is installed. It sets the options for that plugin.

<dl>
<dt>Nick to highlight </dt>
<dd>Type a nick name, and select a color from the palette at the bottom of the tab. The nick name will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

<dt>Host to highlight </dt>
<dd>If populated, that host or any host that the text is part of, will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

</dl>

<div id="rank">rank* - a local terminology representing a subset of [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Modes user modes] on channel, such as Voice, Op, Half Op, etc. The ranks are listed on the [[Colors#Nick List tab|Nick List tab]]. </div>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:UI]]
[[Category:Common Usage]]
[[Category:Advance Usage]]