Wikipedia:IRC/Tutorial

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?

Having access to a modern web browser should suffice. Follow this link to visit Wikipedia's help channel.

To access the freenode IRC servers, you could also use an IRC client. Text clients include irssi, ircII and BitchX. Graphical clients include Pidgin for Windows or Unix-like OSes, HexChat for Windows, Unix, or Mac, (although certain HexChat features are not supported on Windows and Mac), mIRC for Windows and 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 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. HexChat (http://hexchat.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 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 chat.freenode.net to reach the main rotation of servers. You can also find a full list by executing:

• host chat.freenode.net (Linux)
• nslookup chat.freenode.net (Windows)

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 tutorial or this IRC primer on 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): /msg nickserv register password email@address.tld, of course substituting password for any password of your choosing, and email@address.tld 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. Please note that disposable/throwaway emails are not allowed and doing so could delay or negatively affect your registration.

Registering your nick will also allow you to be added to a channel's access list; for example, some of the people in #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: /msg nickserv identify password

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: /msg nickserv help

Setting your IRC client to identify upon connect

Some IRC clients allow you to automatically issue commands when connecting to a server:

mIRC

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

ChatZilla

1. From the menu choose ChatZilla -> Preferences. Navigate to Global Settings.
2. Navigate to the Startup tab. Scroll down to Locations.
3. Click Add and use the following formats to add a network and channel, and to identify:

   irc://irc.freenode.net/wikipedia-en

   ircs://freenode/nickserv,isnick?msg=identify%20yourpassword

   (in the last example replace yourpassword with your freenode account password)

4. Click Apply, followed by OK, to get out of the ChatZilla Preferences dialog
5. 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
6. To bookmark a channel without joining it automatically at startup, drag the tab for that channel directly to Firefox's Bookmarks Toolbar or Menu

HexChat (Windows version)

1. Go to HexChat. Select Network list. You will see five boxes for you to fill in:

   Nickname: The nick you wish to connect with by default.

   Second choice (optional): An alternative nick if the first is unavailable.

   Third choice (optional): As above.

   User name (optional): This is your ident. For example, in example@Wikipedia/Jimbo-Wales, "example" would be generated from this field. This can be anything you want, with a maximum of nine characters.

   Real name (optional): This is your "real name" field, visible when the command /whois 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.

2. Once the details have been completed, highlight the FreeNode tab under "Networks". Then click the "Edit..." tab.
3. Click "Add" next to "Servers for FreeNode". Type the following:

   irc.freenode.net/6667 This is the port you can use to connect to the network. See also the advanced section below.

4. Check the "Use global user information" box under "Your details".
5. Check the "Auto connect to this network on startup" box under "Connecting".
6. In the "Favorite channels" box, fill out the channels you wish to join automatically in this format:

   #Wikipedia,#wikipedia-en,#Wikimedia,#mediawiki ... Please note, however, that there is a 256 character limit for this option (see also the advanced section below).

7. Leave the "Connect command" and "NickServ password" fields blank. In the "Server password" box, type the password you use to identify yourself to NickServ.
8. Finally, select your character set (by default, "IRC (Latin/Unicode Hybrid)" is selected).
9. Now click "Close" and you should be all set. Close HexChat and reboot; you should now be identified and connected to your selected channels.

Advanced options for HexChat

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

1. Open Notepad.
2. You can specify your user modes (see /quote help umode) on the first line. For example, you could type (without the leading /):

   mode +iw

3. On the second line, type idchans
4. On the third line, you can type out the channels you intend to join. Type in the following format:

   timer 5 join #Wikipedia,#wikipedia-en,#Wikimedia,#mediawiki ...

5. Save the file as autojoin.txt
6. Navigate to HexChat, Network list, highlight FreeNode and click "Edit..."
7. 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.
8. In the "Connect command" box, type:

   LOAD -e autojoin.txt

9. Close HexChat and reboot. The changes should now take effect.

You can also use HexChat 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.

1. Navigate to HexChat, Network list, highlight FreeNode and click "Edit..."
2. Highlight the entry under "Servers for freenode" (for example, irc.freenode.net/6667) and click the edit tab.
3. Change this line to:

   irc.freenode.net/7000

4. Under "Connecting", check these tickboxes:

   "Use SSL for all the servers on this network"

   "Accept invalid SSL certificate"

5. Click "close".
6. Close HexChat 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)

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

Then you can run irc client with C-c i

Pidgin

1. click Accounts -> Add/Edit.
2. Click the Add button.
3. Change the protocol to IRC and enter chat.freenode.net as the server.

   • Nickname

4. To register your nickname. Click on Buddies>New Instant Message>Fill in NickServ for Name.

   • send a message "register PASSWORD EMAIL" (where the CAPs are replaced by your info)

5. click join a chat and add the channel, ie. #wikipedia-en-help

Trillian

1. Go to the "Manage Accounts" screen
2. Press "Add New Account"
3. Choose IRC from the list
4. Fill in the details for:

   • Account Name ( What you'd like to call the connection )

     Nickname ( What you'd like users to see as your "name" )

     Server Host ( Should be set to irc.freenode.net )

5. Connect the Account. You should see a "status window" pop up. You can close it at any time
6. Click on the "Other Connections" button (furthest on the right from the "Status" field)
7. Browse to IRC
8. Click on "Join a Channel"
9. Enter the name of the channel you'd like to enter.

Quassel

1. Go to Settings, Configure Quassel...
2. In the left pane, click "Networks" (under "IRC")
3. Select the "Auto Identify" tab.
4. Check the "Auto Identify" checkbox, and fill in the server (should be NickServ) and your password.
5. Click "Apply" at the bottom, and then "OK" to close the window.

Applying for a host cloak

See the instruction page on Meta-Wiki.

"Unaffiliated" cloaks

If you'd like a cloak that doesn't advertise Wikipedia, please ask in #freenode for an unaffiliated cloak or if you're looking for a member of freenode's staff directly, you can do so via the /stats p command or join #freenode and use the /who freenode/staff/* command in your IRC client.

IRC channel list

Main article: m:IRC/Channels

Channels on freenode include but are not limited to:

• #mediawiki^connect - for users/questions about MediaWiki, the software that makes Wikipedia possible
• #wikia^connect - About Wikia
• #wikibooks^connect - About Wikibooks (in English).
• #wikimedia^connect - Wikimedia Foundation
• #wikimedia-commons^connect - Wikimedia Commons
• #wikinews^connect - Wikinews
• #wikipedia^connect - Wikipedia
• #wikipedia-en-help^connect - Channel for new Wikipedians to join and ask questions.
• #wikipedia-en^connect - 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 portforward.com and ask them for help.

What are some basic commands?

Here are some basic commands for IRC: (as taken from Wikibooks)

Command	What it does	Example
/attach /server	Sign on to a server	/attach irc.freenode.net /server irc.freenode.net
/nick	Set your nickname	/nick YourName
/join /j	Join a channel	/join #en.wikibooks /j #en.wikibooks
/msg	Sends a message (can either be private or to the entire channel)	Message the channel: /msg #en.wikibooks Hello, World! Send a private message: /msg JohnDoe Hi, John.
/whois	Display information about a user on the server	/whois JohnDoe
/stats p	Displays a list of active, on-call network staff	/stats p
/clear /clear all	Clears a channel's text. Clears all open channel's text.	/clear /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: /me loves pie. would output to the chat in the case of JohnDoe: 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)