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

From ReactOS Wiki
Jump to: navigation, search
m
(cleanup)
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|For a complete list of all ReactOS IRC channels, please see [http://www.reactos.org/community/irc IRC]}}
 +
 
 +
This tutorial will guide you through setting up [http://en.wikipedia.org/wiki/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.
  
 
==Downloading==
 
==Downloading==
*'''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
+
*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
+
*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'''
+
*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.  
**Note: If you are having problems getting to this point you may need additional help. See the [http://www.reactos.org/forum/ forums]
+
*Run the file (if you have the option), or save it to your computer then run it
  
 
==Installing==
 
==Installing==
Line 23: Line 25:
 
**'''To use the default folders, click Next'''
 
**'''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 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)
 
**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===
 
===Nickname and Profile===
[[File:KVIRC-Setup.png|left|thumb|KVIrc Setup]]
+
[[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.
 
*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. ,./<>?;':"[]{}~!@#$%^&*()-_=+)
 
**It appears to accept any characters besides spaces, but some servers may not support some characters (e.g. ,./<>?;':"[]{}~!@#$%^&*()-_=+)
Line 33: Line 34:
 
*Age, Gender, Location, and Languages you speak
 
*Age, Gender, Location, and Languages you speak
 
*Click Next
 
*Click Next
 
  
 
===Theme===
 
===Theme===
  
[[File:KVIrc-Theme.png|left|thumb|KVIrc Theme]]
+
[[File:KVIrc-Theme.png|right|thumb|KVIrc Theme]]
 
*Choose a theme for KVIrc
 
*Choose a theme for KVIrc
 
**I suggest choosing the "Don't Apply Any Theme" option, then downloading another theme later if you like,
 
**I suggest choosing the "Don't Apply Any Theme" option, then downloading another theme later if you like,
Line 43: Line 43:
 
**I suggest XCrystall Black, System 2.0, or DarkMatter
 
**I suggest XCrystall Black, System 2.0, or DarkMatter
 
*Click Next
 
*Click Next
 
 
  
 
===Default Client===
 
===Default Client===
Line 50: Line 48:
  
 
===Servers===
 
===Servers===
[[File:KVIrc-Servers.png|left|thumb|KVIrc 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''
 
''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
 
*Scroll down until you see "Freenode" in the list
Line 57: Line 55:
 
**Suggested are the "chat.**.freenode.net" servers
 
**Suggested are the "chat.**.freenode.net" servers
 
*Press "Advanced"
 
*Press "Advanced"
 
  
 
===Password===
 
===Password===
[[File:KVIrc-Pass.png|left|thumb|KVIrc Password]]
+
[[File:KVIrc-Pass.png|right|thumb|KVIrc Password]]
 
*Enter a password in the password field
 
*Enter a password in the password field
 
*Click on the "Connection" tab
 
*Click on the "Connection" tab
 
 
 
 
 
  
 
===Secure Connection===
 
===Secure Connection===
  
[[File:KVIrc-Secure.png|left|thumb|KVIrc Secure]]
+
[[File:KVIrc-Secure.png|right|thumb|KVIrc Secure]]
 
*Change the port to 6697
 
*Change the port to 6697
 
*Choose "Connect to this server at startup"
 
*Choose "Connect to this server at startup"
 
*Choose "Use SSL Protocol"
 
*Choose "Use SSL Protocol"
 
*Click on the "Join Channels" tab
 
*Click on the "Join Channels" tab
 
 
 
  
 
===Channels===
 
===Channels===
''Click [http://www.reactos.org/en/community_irc.html here] for more channels''
+
[[File:KVIrc-Channels.png|right|thumb|KVIrc Channels]]
[[File:KVIrc-Channels.png|left|thumb|KVIrc Channels]]
+
*Enter "#reactos" (or any other channel name) in the same box as the picture
*Enter "#reactos" in the same box as the picture
 
 
*Click "Add"
 
*Click "Add"
 
*Click "OK"
 
*Click "OK"
Line 95: Line 83:
 
==Registration==
 
==Registration==
 
If you haven't used Freenode before, you will need to register your nickname the first time you connect
 
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]]
+
[[File:KVIrc-Register.png|right|thumb|KVIrc Register]]
 
*Make sure you have selected "Freenode" on the left and not "#reactOS", as in the picture
 
*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>"
 
*Type the following message: "/msg nickserv register <password> <email>"
 
**<password> is the password you entered a few steps back
 
**<password> is the password you entered a few steps back
 
**<email> is your email address
 
**<email> is your email address
**don't type the "<" or the ">"
 
 
 
 
  
 
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
Line 110: Line 94:
 
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
 
 
 
[[File:KVIrc-Buttons.png|left|thumb|KVIrc Buttons]]
 
<br style="clear: both" />
 
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 15:03, 29 April 2013

Imbox notice.png

Notice: For a complete list of all ReactOS IRC channels, please see IRC

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). 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. 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 (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

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. I believe this is all publicly viewable.
  • Age, Gender, Location, and Languages 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
  • Press "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