Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

45 lines (44 sloc) 5.718 kb
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="">
<title>quIRC: Tutorial</title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8;" />
<link rel="stylesheet" href="readme.css" />
<div id="title">
<h1>quIRC: Tutorial</h1>
<h5>quIRC is a lightweight terminal-based <acronym title="Internet Relay Chat">IRC</acronym> client. It is written in C.</h5>
<div id="contents">
<li><a href="#foreword">Foreword</a></li>
<li><a href="#irc">Internet Relay Chat</a></li>
<li><a href="#start">Getting Started with quIRC</a></li>
<div id="foreword">
<p>I like to engage with my user population. I welcome bug reports, feature requests, patches, and even undirected rambling musings about what direction quIRC should take in the future. If you use (or are considering using) quIRC, please drop into #quirc on for a chat.</p>
<p>This is a tutorial for new users. There is also a <a href="readme.htm">reference manual</a>.</p>
<div id="irc">
<h2>Internet Relay Chat</h2>
<p><acronym title="Internet Relay Chat">IRC</acronym> is an Internet chat protocol. It is mainly designed for group communication in discussion forums, called <em>channels</em>, but also allows one-to-one communication via private message. For an overview see <a href="">the Wikipedia article on IRC</a>. There is a good IRC primer for newbies on <a href=""></a>.</p>
<p>There are several IRC <em>networks</em>, each of which consists of a tree of <em>servers</em> to which users (&apos;<em>clients</em>&apos;) connect. Each user on a given network is identified by a <em>nick</em>, which may be their name or a handle. Users can communicate through private messaging, but most conversations take place in <em>channels</em>. A channel is analogous to a room; a line typed into a channel by one user is seen by all other users in that channel.</p>
<p>Channels are policed by <em>chanops</em> (<em>channel operators</em>), who have the power to <em>kick</em> clients out of a room or even <em>ban</em> them. Different channels will have different rules on what is acceptable.</p>
<div id="start">
<h2>Getting Started with quIRC</h2>
<p>Assuming your distributor hasn&apos;t packaged quIRC, the first thing you will need to do is compile it. After downloading the source tarball (or cloning the <tt>git</tt> repository) run <tt>make; sudo make install</tt>. This should compile quIRC and install it under <tt>/usr/local</tt>; to install somewhere else (eg. if <tt>/usr/local</tt> is not in your <tt>$PATH</tt>), you will need to change the definition of <tt>PREFIX</tt> in the <tt>Makefile</tt>. One possible problem at this stage is that your libc may not support asynchronous DNS lookups (<tt>getaddrinfo_a()</tt>), in which case you will need to edit <tt>config.mak</tt> (if it's not present, copy the stock version from <tt>dist/</tt>), uncommenting the two lines under &quot;<tt># uncomment if your libc does not support getaddrinfo_a</tt>&quot;. Similarly, if your libc produces errors with <tt>intmax_t</tt> (eg. musl libc with gcc), uncomment the <tt>config.mak</tt> line under &quot;<tt># uncomment if you encounter errors with intmax_t and %jd</tt>&quot;. Also, if your C compiler is not <tt>gcc</tt>, you will need to change <tt>CC</tt> (and probably also <tt>CFLAGS</tt> and <tt>OPTFLAGS</tt>) in the Makefile. Finally, note that if you cloned the repository, the Makefile is actually split into two parts, <tt>Makefile</tt> and <tt>distMakefile</tt>, and most of these variables are defined in the latter.</p>
<p>If all of this sounds complicated, and you are running Linux on x86, you can just download the binary tarball (though you will still need to <tt>sudo make install</tt>). Alternatively, OpenSUSE and SLE users can use the package from <a href="">the openSUSE Build Service</a>. Others should pester their distributor to provide a package.</p>
<p>Once you&apos;ve installed quIRC, you will want to connect to a server and join a channel. Good places to start are #quirc on NewNet, #newbies on EFnet, or #irchelp on ColdFront. We&apos;ll walk you through connecting to #quirc.</p>
<p>First, choose and set your nickname; you can use your real name or any handle you like to go by. Try not to pick anything too common, like &apos;john&apos;, as it&apos;s likely to already be in use. Set your nickname with <tt>/nick <em>yournickhere</em></tt>.</p>
<p>Next, connect to the NewNet network, with <tt>/server</tt>. A new tab will open, and various information, including the <acronym title="Message Of The Day">MOTD</acronym>, will scroll by. If you get a message like &quot;foobar: Nickname is in use&quot;, choose a different nick.</p>
<p>Now you&apos;re ready to join the channel; type <tt>/join #quirc</tt>. Another new tab will open (you can switch between tabs at any time with Ctrl-left and Ctrl-right or by typing <tt>/tab <em>n</em></tt> or pressing the F<em>n</em> key to switch to tab <em>n</em>) and the channel topic will be displayed.</p>
<p>Any messages you type into this tab will be sent to all the other users on the channel. Say hello!</p>
<p>You might find that you don&apos;t get an answer straight away, particularly if the channel isn&apos;t very busy. It&apos;s a good idea to be patient.</p>
Jump to Line
Something went wrong with that request. Please try again.