This tutorial is specifically for the freenode IRC network, the network that Wikiafripedia uses for IRC communication. Some features on this network aren't necessarily on other networks, and features on other networks aren't necessarily here.
Option 1: Use IRC in a browser tab (easy as 1, 2, 3)[edit source | edit]
In a modern web browser follow this link to visit Wikiafripedia's help channel.
Option 2: choose which IRC client to use (advanced)[edit source | edit]
Alternatively, to access the freenode IRC servers, you could also use an IRC client. 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: These require administrative access on the computer.
- 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. Textual and Colloquy (GPL/BSD) are available for Mac. Quassel IRC is also easy to set up on Windows, Linux, BSD, and Mac.
- Browser-attached client: These install as a web browser add-on and do not require administrative access.
- 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.
- freenode official webchat (hosted by freenode)
- KiwiIRC - KiwiIRC, a free web-based client (Apache License 2.0). This also is mobile-friendly.
- IRCCloud, a freemium IRC chat client (very easy to use and set up).
- Other 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).
How do I connect?[edit source | edit]
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:
Having connection problems?[edit source | edit]
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[edit source | edit]
Nickname registration[edit source | edit]
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@example.com, of course substituting
password for any password of your choosing, and
firstname.lastname@example.org 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[edit source | edit]
Some IRC clients allow you to automatically issue commands when connecting to a server:
mIRC[edit source | edit]
- 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:
/msg nickserv identify yourpassword
- Click OK as many times as you need to get out of the menus and you're all done.
ChatZilla[edit source | edit]
- 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 network and channel, and to identify:
- (in the last example replace yourpassword 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
HexChat (Windows version)[edit source | edit]
- 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@Wikiafripedia/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 Wikiafripedia username, or a URL to your account. It can be anything you want.
- Once the details have been completed, highlight the FreeNode tab under "Networks". Then click the "Edit..." tab.
- Click "Add" next to "Servers for FreeNode". Type the following:
- chat.freenode.net/6667 This is the port you can use to connect to the network. See also the advanced section below.
- 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:
- #Wikiafripedia,#wikipedia-en,#Wikimedia,#mediawiki ... Please note, however, that there is a 256 character limit for this option (see also the advanced section below).
- 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 HexChat and reboot; you should now be identified and connected to your selected channels.
Advanced options for HexChat[edit source | edit]
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.
- Open Notepad.
- You can specify your user modes (see
/quote help umode) on the first line. For example, you could type (without the leading /):
- mode +iw
- On the second line, type idchans
- On the third line, you can type out the channels you intend to join. Type in the following format:
- timer 5 join #Wikiafripedia,#wikipedia-en,#Wikimedia,#mediawiki ...
- Save the file as autojoin.txt
- Navigate to HexChat, 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:
- LOAD -e autojoin.txt
- 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.
- Navigate to HexChat, Network list, highlight FreeNode and click "Edit..."
- Highlight the entry under "Servers for freenode" (for example, chat.freenode.net/6667) and click the edit tab.
- Change this line to:
- Under "Connecting", check these tickboxes:
- "Use SSL for all the servers on this network"
- "Accept invalid SSL certificate"
- Click "close".
- Close HexChat and restart the program. The changes should now take effect.
Emacs (ERC)[edit source | edit]
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 "chat.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 "chat.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[edit source | edit]
- click Accounts -> Add/Edit.
- Click the Add button.
- Change the protocol to IRC and enter chat.freenode.net as the server.
- 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)
- click join a chat and add the channel, ie. #wikipedia-en-help
Trillian[edit source | edit]
- Go to the "Manage Accounts" screen
- Press "Add New Account"
- Choose IRC from the list
- 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 chat.freenode.net )
- Connect the Account. You should see a "status window" pop up. You can close it at any time
- Click on the "Other Connections" button (furthest on the right from the "Status" field)
- Browse to IRC
- Click on "Join a Channel"
- Enter the name of the channel you'd like to enter.
Quassel[edit source | edit]
- Go to Settings, Configure Quassel...
- In the left pane, click "Networks" (under "IRC")
- Select the "Auto Identify" tab.
- Check the "Auto Identify" checkbox, and fill in the server (should be NickServ) and your password.
- Click "Apply" at the bottom, and then "OK" to close the window.
Applying for a host cloak[edit source | edit]
"Unaffiliated" cloaks[edit source | edit]
If you'd like a cloak that doesn't advertise Wikiafripedia, 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[edit source | edit]
Channels on freenode include but are not limited to:
- #mediawiki - for users/questions about MediaWiki, the software that makes Wikiafripedia possible
- #wikia - About Wikia
- #wikibooks - About Wikibooks (in English).
- #wikimedia - Wikimedia Foundation
- #wikimedia-commons - Wikimedia Commons
- #wikinews - Wikinews
- #wikipedia - Wikiafripedia
- #wikipedia-en-help - Channel for new Wikiafripedians to join and ask questions.
- #wikipedia-en - English Wikiafripedia
IRC client settings[edit source | edit]
- 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![edit source | edit]
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?[edit source | edit]
Here are some basic commands for IRC: (as taken from Wikibooks)
|Command||What it does||Example|
|Sign on to a server||/attach chat.freenode.net |
|/nick||Set your nickname||/nick YourName|
|Join a channel||/join #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|
|Clears a channel's text.
Clears all open channel's text.
|/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)