View source for Wikipedia:IRC/Tutorial

{{WP help pages (header bar)}}
{{notice|Please make sure you have [[Firewall (networking)|firewall]] and [[antivirus software]] installed before following the tutorial below.}}
{{shortcut|WP:IRCT|WP:IRC/T}}

{{TOCright}}
This tutorial is specifically for the [[freenode]] IRC network, the network that Wikipedia uses for IRC communication. Some features on this network aren't necessarily on other networks, and features on other networks aren't necessarily here.

==The Basics==
===What do I need to connect?===
To access the freenode IRC servers, you'll first need an IRC client. Text clients include [[irssi]], [[ircII]] and [[BitchX]]. Graphical clients include [[Pidgin (software)|Pidgin]] for Windows or Unix-like OSes, [[xchat]] for Windows, Unix, or Mac, (although certain xchat features are not supported on Windows and Mac), [[mIRC]] for Windows and [[Colloquy (IRC client)|Colloquy]] for Mac. Finally, regardless of your OS of choice, if you are browsing the Internet with [[Firefox]], you may use the [[ChatZilla]] extension. Packages for various IRC clients may be included on your operating system install CDs and links to web sites for the client software can be found [http://www.irc.org/links.html here].  Trillian also has an IRC client where you have to check the text box for plug ins.

2011: There are three types of graphical clients for IRC: the independent program client, the web browser Add-On client and the web-client started by opening up a website. 

*Stand-Alone clients: For Windows, for many years the major graphical client for Windows has been mirc (http://mirc.com). pidgin (http://www.pidgin.im) is also available. xchat (http://xchat.org/) is available for Windows as well and is a flexible professional opensource package which stands alone and can be extensively modified by the experienced person.

*Browser-attached client: For platforms that the Firefox Browser supports (Windows, Mac and Unix) there is an IRC client called ChatZilla. ChatZilla is built-in to [[SeaMonkey]], and [[Opera (web browser)|Opera]] also has a built-in client.

*Web-page clients: The major web-client is mibbit.com and some networks host the open source qwebirc (http://www.qwebirc.org/). Some users use web-clients based on cgi:irc (http://cgiirc.org). These will work on any Javascript enabled web browser.

==How do I connect?==
Once you have a client, you'll need a server. You can simply use irc.freenode.net to reach the main rotation of servers; or, you can find a more geographically local server [http://freenode.net/irc_servers.shtml here].

===Having connection problems?===
After you've obtained your client and the name of a server, you may still need a bit of help in getting connected. Take a look at this [http://www.irchelp.org/irchelp/irctutorial.html tutorial] or this [http://www.irchelp.org/irchelp/ircprimer.html IRC primer] on [http://www.irchelp.org irchelp.org], which contains a variety of other useful information as well.

==About the network services==
===Nickname registration===
If you want to use a certain nickname on the network and don't want anyone else to take it, you must register it with the network.

You can do so by typing (in any window): <code>/msg nickserv register <font color="purple">password</font> <font color="dark green">email@address.tld</font></code>, of course substituting <code><font color="purple">password</font></code> for any password of your choosing, and <code><font color="dark green">email@address.tld</font></code> with your email address. Try not to make your password too predictable or guessable, but also avoid using any password you use elsewhere since it's very easy to accidentally type your password into an IRC channel revealing it to others.  You should now check your email for the confirmation message from freenode, and complete the steps it contains.

Registering your nick will also allow you to be added to a channel's access list; for example, some of the people in [irc://irc.freenode.net/wikipedia-en-help #wikipedia-en-help] have +'s beside their nicknames (to identify "helpers").

Note: You only have to register your nickname once. Every other time you connect from that point on, you need to prove who you are, with this command: <code>/msg nickserv identify <font color="purple">password</font></code>

Some IRC clients allow you to set performs (this is: command or commands that will automatically be performed on connect) so this would be an ideal command to put in your perform list. On mIRC, you can find the perform list at: File | Select Server.. | Options | Perform.

There are some other options you can set (as well as privacy options), you'll want to get a list by typing: <code>/msg nickserv help</code>

====Setting your IRC client to identify upon connect====
Some IRC clients allow you to automatically issue commands when connecting to a server:

=====mIRC=====

# Go to File, Select Server, Options, Perform
# Go to Network, click Add, find 'freenode' in the list and click OK.
# In the Perform Commands section, add: 
#* <code>/nick nickname_you_want</code>
#* <code>/msg nickserv identify yourpassword</code>
# Click OK as many times as you need to get out of the menus and you're all done.

=====ChatZilla=====

# From the menu choose ChatZilla -> Preferences. Navigate to Global Settings.
# Navigate to the Startup tab. Scroll down to Locations.
# Click Add and use the following formats to add a <tt>network</tt> and <tt>channel</tt>, and to identify:
#: <tt><nowiki>irc://irc.freenode.net/wikipedia-en</nowiki></tt>
#: <tt><nowiki>ircs://irc.freenode.net:6697/%23%23defocus</nowiki></tt>
#: <tt><nowiki>ircs://freenode/nickserv,isnick?msg=identify%20yourpassword</nowiki></tt>
#: (in the last example replace <tt>yourpassword</tt> with your freenode account password)
# Click Apply, followed by OK, to get out of the ChatZilla Preferences dialog
# To add all of your channels individually in the same format once you've joined them, right-click the tab of each channel -> Open this Channel at Startup
# To bookmark a channel without joining it automatically at startup, drag the tab for that channel directly to Firefox's Bookmarks Toolbar or Menu

=====X-Chat (Windows version)=====

# Go to XChat. Select Network list. You will see five boxes for you to fill in:
#: <tt>Nickname</tt>: The nick you wish to connect with by default.
#: <tt>Second choice</tt> (optional): An alternative nick if the first is unavailable.
#: <tt>Third choice</tt> (optional): As above.
#: <tt>User name</tt> (optional): This is your ident. For example, in <tt>example@Wikipedia/Jimbo-Wales</tt>, "example" would be generated from this field. This can be anything you want, with a maximum of nine characters.
#: <tt>Real name</tt> (optional): This is your "real name" field, visible when the command <tt>/whois</tt> is used. This doesn't necessarily have to be your real name; you could just have your Wikipedia username, or a URL to your account. It can be anything you want.
# Once the details have been completed, highlight the <tt>FreeNode</tt> tab under "Networks". Then click the "Edit..." tab.
# Click "Add" next to "Servers for FreeNode". Type the following:
#: <tt>irc.freenode.net/6667</tt> <small>This is the port you can use to connect to the network. See also the advanced section below.</small>
# Check the "Use global user information" box under "Your details". 
# Check the "Auto connect to this network on startup" box under "Connecting". 
# In the "Favorite channels" box, fill out the channels you wish to join automatically in this format:
#: <tt>#Wikipedia,#wikipedia-en,##defocus,#Wikimedia ...</tt> <small>Please note, however, that there is a 256 character limit for this option (see also the advanced section below).</small>
# Leave the "Connect command" and "NickServ password" fields blank. In the "Server password" box, type the password you use to identify yourself to NickServ.
# Finally, select your character set (by default, "IRC (Latin/Unicode Hybrid)" is selected).
# Now click "Close" and you should be all set. Close X-Chat and reboot; you should now be identified and connected to your selected channels.

======'''Advanced options for X-Chat'''======

There are a few advanced options available for X-Chat. If you join more channels than the 256 character limit allows, you can set up an alternative autojoin using Notepad. 

# Open Notepad. 
# You can specify your [http://freenode.net/using_the_network.shtml user modes] on the first line. For example, you could type (without the leading <tt>/</tt>):
#: <tt>mode +iw</tt>
# On the second line, type <tt>idchans</tt>
# On the third line, you can type out the channels you intend to join. Type in the following format:
#: <tt>timer 5 join #Wikipedia,#wikipedia-en,##defocus,#Wikimedia ...</tt>
# Save the file as autojoin.txt
# Navigate to XChat, Network list, highlight FreeNode and click "Edit..."
# If you specified "Favorite channels", you may now delete the contents of this field if you wish; the autojoin will be retrieved from the Notepad file.
# In the "Connect command" box, type:
#: <tt>LOAD -e autojoin.txt</tt> 
# Close X-Chat and reboot. The changes should now take effect.

You can also use X-Chat to connect to freenode using a secure connection (SSL). To do this, you will need to specify a different port and alter the settings slightly. 

# Navigate to XChat, Network list, highlight FreeNode and click "Edit..."
# Highlight the entry under "Servers for freenode" (for example, <tt>irc.freenode.net/6667</tt>) and click the edit tab.
# Change this line to: 
#: <tt>irc.freenode.net/7000</tt>
# Under "Connecting", check these tickboxes:
#: "Use SSL for all the servers on this network"
#: "Accept invalid SSL certificate"
# Click "close". 
# Close X-Chat and restart the program. The changes should now take effect.

=====Emacs (ERC)=====
ERC is part of the GNU project. It is included with recent versions of GNU Emacs.

to run Type: M-x erc - if you run erc in this way you need to pass "irc.freenode.net" as server "6667" as port and your nickname (you can omit the password unless you have registered the nickname).

You can speed up connection process if you put this in your init file (~/.emacs)

<code>
  (defun irc ()
    "Connect to the freenode"
    (interactive)
    (erc :server "irc.freenode.net"
         :port 6667
         :nick "<YOUR NICK>"
         :password "<PASSWORD OR nil>"))
  
  (global-set-key "\C-ci"  'irc)
</code>
Then you can run irc client with `C-c i`

==Applying for a host cloak==
See the [[:m:IRC/Cloaks|instruction page]] on [[:m:Main Page|Meta-Wiki]].

==="Unaffiliated" cloaks===
If you'd like a cloak that doesn't advertise Wikipedia, please follow the instructions at [http://freenode.net/faq.shtml#cloaks http://freenode.net/faq.shtml#cloaks]. If you're looking for a member of freenode's staff, [http://freenode.net/faq.shtml#helpfromstaff this] is how you find them.

===IRC Channel List===
{{main|m:IRC/Channels}}

Channels on freenode include but are not limited to:

* {{Channel|mediawiki}} - for users/questions about [[MediaWiki]], the software that makes Wikipedia possible
* {{Channel|wikia}} - About [[Wikia:|Wikia]]
* {{Channel|wikibooks}} - About [[Wikibooks:|Wikibooks]] (in English).
* {{Channel|wikimedia}} - [http://www.wikimedia.org Wikimedia Foundation]
* {{Channel|wikimedia-commons}} - [[Commons:|Wikimedia Commons]]
* {{Channel|wikinews}} - [[Wikinews:|Wikinews]]
* {{Channel|wikipedia}} - [[Wikipedia]]
* {{Channel|wikipedia-en-help}} - Channel for new Wikipedians to join and ask questions.
* {{Channel|wikipedia-en}} - [http://en.wikipedia.org English Wikipedia]

==IRC Client Settings==
* The ''realname'' (or ''Full Name'') field can be set optional to anything you want.
* The [[ident]] setting should ideally be turned on, and again set to anything you want.

===I want to send a file to someone and it's not working!===
You have to define a port range in your IRC client, add an exception in any firewall software you may be using and allow that port range in your router. Or just go to [http://www.portforward.com portforward.com] and ask them for help.

==What are some basic commands?==
Here are some basic commands for IRC: <small>(as taken from [[Wikibooks:Internet Technologies/IRC#Basic commands|Wikibooks]])</small>

{| class="wikitable"
!Command || What it does || Example
|-
|/attach <br/> /server || Sign on to a server || '''/attach''' irc.freenode.net <br/> '''/server''' irc.freenode.net
|-
|/nick || Set your nickname || '''/nick''' YourName
|-
|/join <br/> /j|| Join a channel || '''/join''' #en.wikibooks <br/> '''/j''' #en.wikibooks
|-
|/msg || Sends a message (can either be private or to the entire channel) || Message the channel: '''/msg''' #en.wikibooks hello world! <br/> Send a private message: '''/msg''' JohnDoe Hi john.
|-
|/whois || Display information about a user on the server || '''/whois''' JohnDoe
|-
|/clear <br/> /clear all || Clears a channel's text. <br/> Clears all open channel's text. || '''/clear''' <br/> '''/clear all'''
|-
|/away || Sets an away message. '''Note: Type /away again to return from away.''' || '''/away''' I'm away because...
|-
|/me || Sends an action to the channel. See example. || The following: <br/> '''/me''' loves pie. <br/> would output to the chat in the case of JohnDoe: <br/> '''JohnDoe''' loves pie.
|-
|/quit || Disconnects you from the IRC network. You can also quit with a quit message. || '''/quit''' Off to bed.
What happens: JohnDoe has quit (Off to bed)
|}

[[Category:Wikipedia how-to|IRC tutorial]]