Skip to content

Commit 53c0be3

Browse files
authored
Add guide for basics & getting started (#161)
* Add guide for basics & getting started * add weight * Update basics.md
1 parent 2d4f39d commit 53c0be3

File tree

1 file changed

+223
-0
lines changed

1 file changed

+223
-0
lines changed

content/_guides/basics.md

Lines changed: 223 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,223 @@
1+
---
2+
title: Basics of IRC
3+
category: about-irc
4+
weight: 10
5+
---
6+
7+
You are likely here because you want to know more about this "IRC" stuff
8+
you've heard about. Someone might have sent you here to get you clued in, or
9+
perhaps it popped up in search results and got your attention.
10+
11+
Welcome, friend. We are glad you found us, whatever the reason.
12+
13+
Hopefully this guide will help you understand what IRC is, and how to start
14+
using it. We think you might like how it differs from other chat platforms.
15+
16+
While this will _not_ be a comprehensive guide on all the software available,
17+
it will hopefully point you in the right direction.
18+
19+
## What is IRC?
20+
21+
IRC stands for Internet Relay Chat. It is a chat protocol.
22+
23+
It was invented in 1988 by Jarkko Oikarinen, of the University of Oulu in
24+
Finland. It replaced a program called MUT (MultiUser Talk).
25+
26+
## How does IRC work?
27+
28+
There are 2 components to IRC.
29+
30+
**Clients** are apps that let you use IRC. They can be installed on many
31+
different Operating Systems, or even run inside your web browser.
32+
33+
**Servers** are what the clients connect to. Libera Chat has a **network** of
34+
servers. Don't worry though, you only need to know one address for the
35+
network. That address is `irc.libera.chat`.
36+
37+
Networks like us use a Round Robin system to distribute users evenly between
38+
servers. Having lots of servers provides redundancy, so one server being out
39+
of order doesn't make the whole network stop.
40+
41+
IRC is usually cost-free to use, but sometimes you might need to buy a client
42+
or pay a subscription fee for a client hosted by someone else.
43+
44+
## Choosing a client
45+
46+
To use IRC, first you need to choose a client. Clients vary a lot, but most
47+
will have the same basic features, so don't worry about picking the wrong one.
48+
49+
You can read our guide [about clients](/guides/clients) to help you make your
50+
decision, or you can use one of [our webchats](/guides/webchat) to avoid
51+
installing anything just yet.
52+
53+
Our webchats are run by us. They are free to use, but we restrict them so they
54+
only connect to `irc.libera.chat`. Because of this, they are a good place to
55+
get started. You can graduate to a proper client once you've figured things
56+
out, with help from people on the network.
57+
58+
## Connecting for the first time
59+
60+
Most clients will have some kind of intro or wizard to get you going. Look for
61+
a preconfigured network called Libera or Libera Chat.
62+
63+
If there is no wizard, or the process is confusing, you will either need to
64+
check out the client's website for some documentation about how to set it up,
65+
or connect through the webchats first and find someone to help. There is
66+
usually someone in `#libera` who can point you in the right direction.
67+
68+
## Talking
69+
70+
Just like in instant messengers, there will be a field in the app where you
71+
will be able to type things. This is where you chat.
72+
73+
This chat field is also where you can do commands to the server or the client.
74+
Commands start with a `/`.
75+
76+
Our website has several [guides](/guides) that will make use of this notation
77+
when giving you instructions.
78+
79+
## Conversation windows
80+
81+
Conversations windows are also known as tabs or buffers. They behave similar
82+
to how you might expect from other chat apps.
83+
84+
In most desktop clients, a list of conversations will be down the left-hand
85+
side in a column. In phone apps, there might be a drawer widget you need to
86+
pull out.
87+
88+
Selecting different items in this list will change what is shown in the main
89+
section of the client, above the field you type chat and commands into.
90+
91+
The top one is probably the name of the network, for Libera Chat it is usually
92+
`Libera`. When you are doing commands you don't want others to see, such as
93+
registering an account, this is a safe place to type them.
94+
95+
Tabs starting with `#` are group chats, which are called `Channels`. On
96+
desktop clients, a user membership list will probably show down the right-hand
97+
side of the screen when you have these conversations selected. On phones the
98+
membership list might be in another drawer widget.
99+
100+
Tabs underneath the channels are private conversations you have with people,
101+
or bots, on the network. These are often referred to as "PMs" (Private
102+
Messages) or "queries".
103+
104+
## Private conversations
105+
106+
You can often start private conversations with someone by double-clicking on
107+
their name, also called a nickname or nick, in the membership list. If that
108+
doesn't work you can achieve the same thing using the `/query` command. For
109+
example, if you wanted to say "hi!" to the person with the nickname "John" you
110+
would do:
111+
112+
```irc
113+
/query john hi!
114+
```
115+
116+
Some people don't like unsolicited private conversations, so only do this with
117+
people you know from talking in channels after asking their permission.
118+
119+
## Services
120+
121+
Services are specialized bots that help the network run smoothly. They manage
122+
users and channels, among other things.
123+
124+
Using services is how you [register a nickname](/guides/registration), and
125+
[identify (log in)](/guides/registration#logging-in) when you return for
126+
another IRC session in the future.
127+
128+
They're also how you [register channels](/guides/creatingchannels) if you ever
129+
need to do that.
130+
131+
## Topics
132+
133+
In most IRC clients, a channel's topic description can be found at the top of
134+
the screen. If you can't see all of it, you can have it displayed to you using
135+
the `/topic` command.
136+
137+
You can find new channels [using a service](/guides/findingchannels) to search
138+
by channel name or by topic description.
139+
140+
There are lots of different topics on any IRC network. On Libera Chat, most of
141+
our channels are about freely-licenced software and collaborative projects.
142+
Our [network policy](/policies) define what we want the network to be like.
143+
144+
## Channel roles
145+
146+
When you're in channels, you might notice that some people in the membership
147+
list have symbols next to their nicknames. Most people will not have a role in
148+
the channels.
149+
150+
The people with symbols have either the "Operator" or "Voiced" roles.
151+
Operators are the people that run that specific channel. They do things like
152+
change channel modes, curate the topic, manage channel access. They're also
153+
responsible for moderating the chat, so sometimes they might silence people
154+
individually or set the channel to moderated mode. When the channel is in
155+
moderated mode, Voiced users comments can still be seen. Often channels will
156+
give Voiced or Operator roles to their helper bots.
157+
158+
## IRC commands cheat sheet
159+
160+
This is a very small sample of commands that you may find useful as you get
161+
started learning IRC. In many clients, there might be buttons for these.
162+
163+
Command parts shown in `[]` are optional.
164+
165+
- `/join #libera`
166+
- Enter the channel `#libera`.
167+
- `/part [#libera] [message]`
168+
- Exit the channel `#libera`.
169+
- If no channel is given, you will part the channel you type this into.
170+
- The optional message will be shown to only this channel on your departure.
171+
- `/nick nickname`
172+
- Changes your nickname to the one you specify.
173+
- `/msg nickname message`
174+
- Sends a private message to user "nickname" _without_ opening a new
175+
conversation window.
176+
- `/query nickname [message]`
177+
- Open a conversation window with user "nickname", and optionally include a
178+
message.
179+
- The other user will _not_ know you did this until you send messages.
180+
- This is useful for ensuring your conversation goes to the correct place,
181+
such as when you're [registering](/guides/registration) with `NickServ`.
182+
- `/me action`
183+
- Use this for emotes. It will appear something like `* Nickname action`.
184+
- `/quit [message]`
185+
- Disconnects you from the network.
186+
- The optional message will be shown to every channel you are in.
187+
188+
Some commands will differ in implementation depending on your client. If the
189+
following do not work as expected, see your client's website for documentation
190+
or ask in their IRC channel. Many have [channels](/guides/findingchannels) on
191+
Libera Chat.
192+
193+
- `/ignore nickname`
194+
- May stop you seeing the user talk. Useful if they are being a pest.
195+
- `/unignore nickname`
196+
- May allow you to see the user again if you change your mind.
197+
- `/ignores`
198+
- May list the current ignores you have set.
199+
200+
## Who runs Libera Chat?
201+
202+
The Libera Chat network is run by volunteers. You can usually
203+
[find the volunteer staff](/guides/faq#how-to-find-libera-chat-staff) in
204+
`#libera`, where their channel role will highlight them in the channel
205+
membership list.
206+
207+
You are invited to message any staff member _without_ asking permission first.
208+
209+
## More resources
210+
211+
If you get lost, you can always join `#libera` and ask questions. That is what
212+
that channel is there for.
213+
214+
If you are unable to [connect to the network](/guides/connect) at all, you can
215+
contact staff by email: <support@libera.chat>
216+
217+
There are many more resources available in the [guides section](/guides) of
218+
our website. This includes a [FAQ](/guides/faq) that might help you with
219+
troubleshooting problems you encounter.
220+
221+
If you want a more technical overview of IRC, some history of the protocol, or
222+
info on future plans, we recommend [ircdocs.horse](https://ircdocs.horse) and
223+
the [IRCV3 working group](https://ircv3.net/) websites.

0 commit comments

Comments
 (0)