Difference between revisions of "Connect to the ReactOS IRC Channels"

From ReactOS Wiki
Jump to: navigation, search
m (Extra Configuration)
m (punctuation)
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This tutorial will guide you through setting up [http://en.wikipedia.org/wiki/KVIrc KVIrc] and connecting to the [http://www.reactos.org/en/community_irc.html ReactOS IRC channels]. KVIrc is the most fully featured and actively developed open source Windows IRC clients; it's also written in C++, licensed under a slightly modified GPL, and is cross-platform.
+
{{Notice|IRC has been replaced with Mattermost, which is accessible on https://chat.reactos.org/.
  
==Downloading==
+
This chat includes a full history.
*'''Visit the [http://www.kvirc.net/?id=releases&lang=en KVIrc Download Page]'''. Choose your operating system (Windows, Linux, OSX, FreeBSD). If you are not sure, you have Windows. For ReactOS, choose Windows. This will take you to the list of releases page
 
*Choose the latest release (4.0.4 from March 2011 is the latest as of March 2012). This will take you to the regional mirror page
 
*The regional mirror page will list several different locations to download the file. Choose one close to you (if you don't know where you are, pick one at random). This will start the download. '''Run the file (if you have the option), or save it to your computer then run it'''
 
**Note: If you are having problems getting to this point you may need additional help. See the [http://www.reactos.org/forum/ forums]
 
  
==Installing==
+
Some channels are still bridged to IRC, but it is recommended to use Mattermost.}}
*First, choose your language (English, French, Dutch, Italian). Press OK
 
*Press "I Agree" to agree to the terms. You should probably read it first
 
*Review the default components. You can choose where to put shortcuts, and whether or not to start KVIrc with Windows. Click Next
 
*Choose the installation folder or leave it to the default setting. Click Install to start installation.
 
**If you would like to install to a flash drive, make sure you specify the folder on your flash drive you would like to install to
 
**If installing to the network, choose the installation folder by its UNC name (e.g. \\Server\Share\KVIrx). This will allow it to work on other computers that run it (untested)
 
*'''When it's complete, leave the "Run KVIrc" box checked and click "Finish"'''
 
  
==Configuration==
+
This tutorial will guide you through setting up [[wikipedia:KVIrc|KVIrc]] and connecting to the [http://www.reactos.org/community/irc ReactOS IRC channels]. KVIrc is the most fully-featured and actively developed open-source Windows IRC clients; it's also written in C++, licensed under a slightly modified GPL, and is cross-platform.
On first run, a setup wizard will launch automatically. If in doubt, read the text at the top of the screen. It will explain the current options
 
*Click Next to proceed
 
*Click Next if you agree to the KVIrc license
 
*This page allows you to choose where to keep the KVIrc settings
 
**'''To use the default folders, click Next'''
 
**If you installed to a flash drive, choose "All settings in shared program folder (portable)"
 
[[Category:Tutorial]]
 
**If you installed to the network and wish to share settings with all users (and allow all users to change settings), specify the network folder with the UNC name again (e.g. \\Server\Share\KVIrc)
 
  
===Nickname and Profile===
+
== Downloading ==
[[File:KVIRC-Setup.png|left|thumb|KVIrc Setup]]
+
*Visit the '''[http://www.kvirc.net/?id=releases&lang=en KVIrc Download Page]'''. Choose your operating system (Windows, Linux, OSX, FreeBSD). For ReactOS, choose Windows, this will take you to the list of releases page.
*Type in a user name. This will be displayed in the chat room when you send messages.
+
*Choose the latest release. This will take you to the regional mirror page.
**It appears to accept any characters besides spaces, but some servers may not support some characters (e.g. ,./<>?;':"[]{}~!@#$%^&*()-_=+)
+
*The regional mirror page will list several different locations to download the file. Choose one close to you (if you don't know where you are, pick one at random). This will start the download.
*You may choose to enter your real name, or leave it as the default. I believe this is all publicly viewable.
+
*Run the file (if you have the option), or save it to your computer then run it.
*Age, Gender, Location, and Languages you speak
 
*Click Next
 
  
 +
== Installing ==
 +
*First, choose your language. Click OK.
 +
*Click "I Agree" to agree to the terms. You should probably read it first.
 +
*Review the default components. You can choose where to put shortcuts, and whether or not to start KVIrc with Windows. Click "Next".
 +
*Choose the installation folder or leave it to the default setting. Click "Install" to start installation.
 +
**If you would like to install to a flash drive, make sure you specify the folder on your flash drive you would like to install to.
 +
**If installing to the network, choose the installation folder by its UNC name (e.g. \\Server\Share\KVIrx). This will allow it to work on other computers that run it (this is untested).
 +
*'''When it's complete, leave the "Run KVIrc" box checked and click "Finish".'''
  
===Theme===
+
== Configuration ==
 
+
On first run, a setup wizard will launch automatically. If in doubt, read the text at the top of the screen. It will explain the current options.
[[File:KVIrc-Theme.png|left|thumb|KVIrc Theme]]
+
*Click "Next" to proceed.
*Choose a theme for KVIrc
+
*Click "Next" if you agree to the KVIrc license.
**I suggest choosing the "Don't Apply Any Theme" option, then downloading another theme later if you like,
+
*This page allows you to choose where to keep the KVIrc settings.
*'''To download additional themes, [http://www.kvirc.net/?id=themes click here]'''
+
**'''To use the default folders, click "Next".'''
**I suggest XCrystall Black, System 2.0, or DarkMatter
+
**If you installed to a flash drive, choose "All settings in shared program folder (portable)".
*Click Next
+
**If you installed to the network and wish to share settings with all users (and allow all users to change settings), specify the network folder with the UNC name again (e.g. \\Server\Share\KVIrc).
 
 
 
 
 
 
===Default Client===
 
*Click Finish
 
 
 
===Servers===
 
[[File:KVIrc-Servers.png|left|thumb|KVIrc Servers]]
 
''If you receive a warning from your antivirus or firewall about this program, allow it access''
 
*Scroll down until you see "Freenode" in the list
 
*Click the arrow to show the list of Freenode servers
 
*Choose a server close to you
 
**Suggested are the "chat.**.freenode.net" servers
 
*Press "Advanced"
 
 
 
 
 
===Password===
 
[[File:KVIrc-Pass.png|left|thumb|KVIrc Password]]
 
*Enter a password in the password field
 
*Click on the "Connection" tab
 
  
 +
=== Nickname and Profile ===
 +
[[File:KVIRC-Setup.png|right|thumb|KVIrc Setup]]
 +
*Type in a user name. This will be displayed in the chat room when you send messages.
 +
**It appears to accept any characters besides spaces, but some servers may not support some characters (e.g. ,./<>?;':"[]{}~!@#$%^&*()-_=+).
 +
*You may choose to enter your real name or leave it as the default.
 +
*You may choose to enter your age, gender, location, and languages which you speak.
 +
*Click "Next".
  
 +
=== Theme ===
  
 +
[[File:KVIrc-Theme.png|right|thumb|KVIrc Theme]]
 +
*Choose a theme for KVIrc
 +
**I suggest choosing the "Don't Apply Any Theme" option, then downloading another theme later if you like.
 +
*'''To download additional themes, [http://www.kvirc.net/?id=themes click here].'''
 +
**I suggest XCrystall Black, System 2.0, or DarkMatter.
 +
*Click Next.
  
 +
=== Default Client ===
 +
*Click "Finish".
  
 +
=== Servers ===
 +
[[File:KVIrc-Servers.png|right|thumb|KVIrc Servers]]
 +
''If you receive a warning from your antivirus or firewall about this program, allow it access.''
 +
*Scroll down until you see "Freenode" in the list.
 +
*Click the arrow to show the list of Freenode servers.
 +
*Choose a server close to you.
 +
**Suggested are the "chat.**.freenode.net" servers.
 +
*Click "Advanced".
  
===Secure Connection===
+
=== Password ===
 +
[[File:KVIrc-Pass.png|right|thumb|KVIrc Password]]
 +
*Enter a password in the password field.
 +
*Click on the "Connection" tab.
  
[[File:KVIrc-Secure.png|left|thumb|KVIrc Secure]]
+
=== Secure Connection ===
*Change the port to 6697
 
*Choose "Connect to this server at startup"
 
*Choose "Use SSL Protocol"
 
*Click on the "Join Channels" tab
 
  
 +
[[File:KVIrc-Secure.png|right|thumb|KVIrc Secure]]
 +
*Change the port to 6697.
 +
*Choose "Connect to this server at startup".
 +
*Choose "Use SSL Protocol".
 +
*Click on the "Join Channels" tab.
  
 
+
=== Channels ===
 
+
[[File:KVIrc-Channels.png|right|thumb|KVIrc Channels]]
===Channels===
+
*Enter "#reactos" (or any other channel name) in the same box as the picture.
''Click [http://www.reactos.org/en/community_irc.html here] for more channels''
+
*Click "Add".
[[File:KVIrc-Channels.png|left|thumb|KVIrc Channels]]
+
*Click "OK".
*Enter "#reactos" in the same box as the picture
 
*Click "Add"
 
*Click "OK"
 
 
*Back at the server list:
 
*Back at the server list:
**Uncheck the "Show this dialog at startup" box
+
**Uncheck the "Show this dialog at startup" box.
**Click "Connect Now"
+
**Click "Connect Now".
**Then click "OK"
+
**Then click "OK".
A window will pop up titled "Join Channels"
+
A window will pop up titled "Join Channels".
*Uncheck the "Show this window after connecting" box and click "Close"
+
*Uncheck the "Show this window after connecting" box and click "Close".
 
 
==Registration==
 
If you haven't used Freenode before, you will need to register your nickname the first time you connect
 
[[File:KVIrc-Register.png|left|thumb|KVIrc Register]]
 
*Make sure you have selected "Freenode" on the left and not "#reactOS", as in the picture
 
*Type the following message: "/msg nickserv register <password> <email>"
 
**<password> is the password you entered a few steps back
 
**<email> is your email address
 
**don't type the "<" or the ">"
 
 
 
 
 
  
 +
== Registration ==
 +
If you haven't used Freenode before, you will need to register your nickname the first time you connect.
 +
[[File:KVIrc-Register.png|right|thumb|KVIrc Register]]
 +
*Make sure you have selected "Freenode" on the left and not "#reactOS", as in the picture.
 +
*Type the following message: "/msg nickserv register <password> <email>".
 +
**<password> is the password you entered a few steps back.
 +
**<email> is your email address.
  
You will receive an e-mail with a confirmation key. Paste the confirmation key into KVIrc
+
You will receive an e-mail with a confirmation key. Paste the confirmation key into KVIrc.
*example: "/msg NickServ VERIFY REGISTER <username> agpzmurtvdnm
+
*Example: "/msg NickServ VERIFY REGISTER <username> agpzmurtvdnm
  
 
Once you have entered the confirmation key you are logged in. There will be no need to identify. You may click "#reactos" in the left pane.
 
Once you have entered the confirmation key you are logged in. There will be no need to identify. You may click "#reactos" in the left pane.
  
==Extra Configuration==
+
== See also ==
Go to the "Settings" menu and click "Configure KVIrc"
+
*[http://www.kvirc.net/ kvirc.net]
*Identities: Go through the General and Avatar tabs, and change the "Part Message" on the "Advanced" tab
 
**Avatars should be 500KB max
 
*I suggest, under "IRC>Query" (query is private chat), choose "Paste last query log"
 
**I picked 50 lines
 
*"General Options>Sound>Sounds": Pick sound files for the first two fields ("New Query opened" and "New Message in inactive query")
 
**If you don't have a sound file handy, navigate to C:\Windows\Media
 
**On Windows 7, I chose "C:\Windows\Media\Sonata\Windows Feed Discovered.wav"
 
*"General Options>Sound>Sound System": choose "winmm" or "qt" under "Sound System". Make sure to test it first.
 
**Media Player doesn't work, don't worry about it
 
 
 
In the main window, above the user list on the right, is a green arrow
 
*Press it
 
*Click the second icon (a box with a horizontal line through it, top is white and bottom is red)
 
*There are now two panes of messages. The top one contains mostly stuff you can ignore, the bottom one contains the chat. Drag the line separating them upwards as you prefer (I like 10 lines on my monitor)
 
 
 
Additionally, in the bottom right corner is another green arrow. Click it, then click the third icon (when you hover, it says "Use friendly commandline mode"
 
 
 
==SSL Certificate==
 
It should connect via SSL without problems; if you receive any warnings about certificates, follow these directions:
 
*Install the necessary root certificate
 
**[http://crt.gandi.net/GandiStandardSSLCA.crt Download this certificate]
 
**The best guides I have found are from [https://wiki.elon.edu/display/TECH/Elon+University+Certificate+Authority Elon University].
 
**Of course, use the certificate linked above and not theirs.
 
 
 
==See Also==
 
*[https://svn.kvirc.de/kvirc/wiki/FAQ KVIrc FAQ]
 
  
 
[[Category:Tutorial]]
 
[[Category:Tutorial]]

Revision as of 10:40, 16 September 2019

Imbox notice.png

Notice: IRC has been replaced with Mattermost, which is accessible on https://chat.reactos.org/.

This chat includes a full history.

Some channels are still bridged to IRC, but it is recommended to use Mattermost.

This tutorial will guide you through setting up KVIrc and connecting to the ReactOS IRC channels. KVIrc is the most fully-featured and actively developed open-source Windows IRC clients; it's also written in C++, licensed under a slightly modified GPL, and is cross-platform.

Downloading

  • Visit the KVIrc Download Page. Choose your operating system (Windows, Linux, OSX, FreeBSD). For ReactOS, choose Windows, this will take you to the list of releases page.
  • Choose the latest release. This will take you to the regional mirror page.
  • The regional mirror page will list several different locations to download the file. Choose one close to you (if you don't know where you are, pick one at random). This will start the download.
  • Run the file (if you have the option), or save it to your computer then run it.

Installing

  • First, choose your language. Click OK.
  • Click "I Agree" to agree to the terms. You should probably read it first.
  • Review the default components. You can choose where to put shortcuts, and whether or not to start KVIrc with Windows. Click "Next".
  • Choose the installation folder or leave it to the default setting. Click "Install" to start installation.
    • If you would like to install to a flash drive, make sure you specify the folder on your flash drive you would like to install to.
    • If installing to the network, choose the installation folder by its UNC name (e.g. \\Server\Share\KVIrx). This will allow it to work on other computers that run it (this is untested).
  • When it's complete, leave the "Run KVIrc" box checked and click "Finish".

Configuration

On first run, a setup wizard will launch automatically. If in doubt, read the text at the top of the screen. It will explain the current options.

  • Click "Next" to proceed.
  • Click "Next" if you agree to the KVIrc license.
  • This page allows you to choose where to keep the KVIrc settings.
    • To use the default folders, click "Next".
    • If you installed to a flash drive, choose "All settings in shared program folder (portable)".
    • If you installed to the network and wish to share settings with all users (and allow all users to change settings), specify the network folder with the UNC name again (e.g. \\Server\Share\KVIrc).

Nickname and Profile

KVIrc Setup
  • Type in a user name. This will be displayed in the chat room when you send messages.
    • It appears to accept any characters besides spaces, but some servers may not support some characters (e.g. ,./<>?;':"[]{}~!@#$%^&*()-_=+).
  • You may choose to enter your real name or leave it as the default.
  • You may choose to enter your age, gender, location, and languages which you speak.
  • Click "Next".

Theme

KVIrc Theme
  • Choose a theme for KVIrc
    • I suggest choosing the "Don't Apply Any Theme" option, then downloading another theme later if you like.
  • To download additional themes, click here.
    • I suggest XCrystall Black, System 2.0, or DarkMatter.
  • Click Next.

Default Client

  • Click "Finish".

Servers

KVIrc Servers

If you receive a warning from your antivirus or firewall about this program, allow it access.

  • Scroll down until you see "Freenode" in the list.
  • Click the arrow to show the list of Freenode servers.
  • Choose a server close to you.
    • Suggested are the "chat.**.freenode.net" servers.
  • Click "Advanced".

Password

KVIrc Password
  • Enter a password in the password field.
  • Click on the "Connection" tab.

Secure Connection

KVIrc Secure
  • Change the port to 6697.
  • Choose "Connect to this server at startup".
  • Choose "Use SSL Protocol".
  • Click on the "Join Channels" tab.

Channels

KVIrc Channels
  • Enter "#reactos" (or any other channel name) in the same box as the picture.
  • Click "Add".
  • Click "OK".
  • Back at the server list:
    • Uncheck the "Show this dialog at startup" box.
    • Click "Connect Now".
    • Then click "OK".

A window will pop up titled "Join Channels".

  • Uncheck the "Show this window after connecting" box and click "Close".

Registration

If you haven't used Freenode before, you will need to register your nickname the first time you connect.

KVIrc Register
  • Make sure you have selected "Freenode" on the left and not "#reactOS", as in the picture.
  • Type the following message: "/msg nickserv register <password> <email>".
    • <password> is the password you entered a few steps back.
    • <email> is your email address.

You will receive an e-mail with a confirmation key. Paste the confirmation key into KVIrc.

  • Example: "/msg NickServ VERIFY REGISTER <username> agpzmurtvdnm

Once you have entered the confirmation key you are logged in. There will be no need to identify. You may click "#reactos" in the left pane.

See also