WikiQueer:IRC/Tutorial

This tutorial is specifically for the freenode IRC network, the network that WikiQueer uses for IRC communication. Some features on this network aren't necessarily on other networks, and features on other networks aren't necessarily here.

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 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 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. 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 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 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 tutorial or this IRC primer on irchelp.org, which contains a variety of other useful information as well.

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):, of course substituting   for any password of your choosing, and   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 #WikiQueer 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:

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:

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:
 * 4) Click OK as many times as you need to get out of the menus and you're all done.
 * 1) Click OK as many times as you need to get out of the menus and you're all done.
 * 1) 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/WikiQueer 
 *  ircs://irc.freenode.net:6697/%23%23defocus 
 *  ircs://freenode/nickserv,isnick?msg=identify%20yourpassword 
 * (in the last example replace yourpassword with your freenode account password)
 * 1) Click Apply, followed by OK, to get out of the ChatZilla Preferences dialog
 * 2) 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
 * 3) 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)

 * 1) Go to XChat. 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</tt> (optional): As above.
 * User name</tt> (optional): This is your ident. For example, in example@WikiQueer/WikiGregory</tt>, "example" would be generated from this field. This can be anything you want, with a maximum of nine characters.
 * Real name</tt> (optional): This is your "real name" field, visible when the command /whois</tt> is used. This doesn't necessarily have to be your real name; you could just have your WikiQueer username, or a URL to your account. It can be anything you want.
 * 1) Once the details have been completed, highlight the FreeNode</tt> tab under "Networks". Then click the "Edit..." tab.
 * 2) Click "Add" next to "Servers for FreeNode". Type the following:
 * irc.freenode.net/6667</tt> This is the port you can use to connect to the network. See also the advanced section below.
 * 1) Check the "Use global user information" box under "Your details".
 * 2) Check the "Auto connect to this network on startup" box under "Connecting".
 * 3) In the "Favorite channels" box, fill out the channels you wish to join automatically in this format:
 * #WikiQueer,#WikiQueer-en,##defocus,#wikimedia ...</tt> Please note, however, that there is a 256 character limit for this option (see also the advanced section below).
 * 1) Leave the "Connect command" and "NickServ password" fields blank. In the "Server password" box, type the password you use to identify yourself to NickServ.
 * 2) Finally, select your character set (by default, "IRC (Latin/Unicode Hybrid)" is selected).
 * 3) 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.


 * 1) Open Notepad.
 * 2) You can specify your user modes on the first line. For example, you could type (without the leading /</tt>):
 * mode +iw</tt>
 * 1) On the second line, type idchans</tt>
 * 2) On the third line, you can type out the channels you intend to join. Type in the following format:
 * timer 5 join #WikiQueer,#WikiQueer-en,##defocus,#wikimedia ...</tt>
 * 1) Save the file as autojoin.txt
 * 2) Navigate to XChat, Network list, highlight FreeNode and click "Edit..."
 * 3) 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.
 * 4) In the "Connect command" box, type:
 * LOAD -e autojoin.txt</tt>
 * 1) 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.


 * 1) Navigate to XChat, Network list, highlight FreeNode and click "Edit..."
 * 2) Highlight the entry under "Servers for freenode" (for example, irc.freenode.net/6667</tt>) and click the edit tab.
 * 3) Change this line to:
 * irc.freenode.net/7000</tt>
 * 1) Under "Connecting", check these tickboxes:
 * "Use SSL for all the servers on this network"
 * "Accept invalid SSL certificate"
 * 1) Click "close".
 * 2) 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 register the nickname).

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

Then you can run irc client with `C-c i`

Applying for a host cloak
Contact WikiQueer to request a WikiQueer host cloak.

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

IRC Channel List
Channels on freenode include but are not limited to:


 * #WikiQueer - WikiQueer

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 and modified slightly from Wikibooks)