Mercurial > pidgin
annotate doc/FAQ @ 14535:e3a640372b6e
[gaim-migrate @ 17256]
Sean requested case-insensitive matching on command, and noted that the plus sign wasn't being unescaped to a space. Both are fixed now.
committer: Tailor Script <tailor@pidgin.im>
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Mon, 11 Sep 2006 22:57:41 +0000 |
parents | 4d87f2dccb6d |
children | 97169e766d9c |
rev | line source |
---|---|
7842 | 1 Gaim: The Pimpin' Penguin IM Clone Thats Good For The Soul |
2 | |
3 1. Compiling and Installing | |
4 | |
9618 | 5 1.1. What does "Gaim" stand for? |
6 1.2. Why can't I compile Gaim? | |
7 1.3. I'm trying to install Gaim, but it complains that I don't have | |
8 libgtkspell.so.0, from where can I get this? | |
9 1.4. What do I need to use the SILC protocol? | |
10 1.5. Is there some way I can compile just Gaim, without all of these | |
11 protocols? | |
12 1.6. I installed a new version of Gaim, but the about window says I'm | |
13 still using the old version. | |
14 1.7. Are the packages signed? If so, by who, and how can I get the | |
15 key? | |
10814
364a2ef907ae
[gaim-migrate @ 12468]
Luke Schierer <lschiere@pidgin.im>
parents:
10717
diff
changeset
|
16 1.8. Can I use Gaim for GTK+ 1.2? |
9618 | 17 1.9. Can I run Gaim on IRIX? |
10473 | 18 1.10. Can I run gaim on MacOSX? |
19 1.11. How do I apply the patch "something.diff"? | |
20 1.12. Why is gaim crashing when I start it? | |
21 1.13. Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? | |
22 1.14. Why do you always say not to use CVS? | |
7842 | 23 |
24 2. Using Gaim | |
25 | |
26 2.1. How do I register for a new account? | |
9618 | 27 2.2. How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other |
28 protocol? | |
29 2.3. How do I change the font Gaim uses? | |
30 2.4. How do I make gaim use emacs-like keybindings? | |
7842 | 31 2.5. How do I use smiley themes? |
32 2.6. Why are the status icons so big? | |
10473 | 33 2.7. Why do the emblems move around the status icon? |
34 2.8. How do I get sound to work correctly? | |
35 2.9. How do I make Gaim use ALSA or OSS for playing sounds? What does | |
8736 | 36 the "Automatic" option do? |
37 Why does Gaim use the same WM_CLASS for every window? It makes | |
10473 | 38 2.10. it impossible to control window size and placement for the buddy |
8736 | 39 list separately from the conversations. |
10473 | 40 2.11. I blocked someone accidentally, how can I unblock them? |
41 2.12. What is a "Buddy Pounce"? | |
42 2.13. Where does gaim store its logs? | |
43 2.14. How can I see my own status with Gaim? | |
44 2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something | |
8736 | 45 else that isn't IM-related? |
7842 | 46 |
47 3. Features | |
48 | |
9618 | 49 3.1. Does Gaim support file transfer? |
50 3.2. Is there a Gaim tray icon, or docklet, or gnome applet, or panel | |
51 icon, or something? | |
52 3.3. What do those colors in the conversation tab mean? | |
53 3.4. Will Gaim save my buddy list to the server? | |
54 3.5. Can I import or export my buddy list? | |
55 3.6. Does Gaim support animated smileys? | |
56 3.7. Can I make Gaim group screen names by the person that owns them? | |
57 You know, like Trillian's Meta Contacts? | |
58 3.8. How do I get the old logging back? | |
59 3.9. How can I convert my old logs to the new format? | |
7842 | 60 |
61 4. ICQ Protocol | |
62 | |
63 4.1. How do I use ICQ? | |
8736 | 64 4.2. Can I send SMS messages? |
7842 | 65 |
66 5. TOC Protocol | |
67 | |
68 5.1. What is the TOC protocol? | |
69 | |
8736 | 70 6. AIM/ICQ (OSCAR) Protocol |
7842 | 71 |
9618 | 72 6.1. Can I set my profile? |
73 6.2. Can I set a buddy icon? | |
74 6.3. Some of my buddies are not showing up as online, why is that? | |
75 6.4. Can I use AIM URI's such as "aim:goim?screenname=robflynn"? | |
76 6.5. I just changed my buddy icon, and I can't see the new one. | |
77 6.6. Does Gaim support DirectIM and IM Image? | |
78 6.7. Can I send SMS messages? | |
79 6.8. Can I add SMS numbers to my buddy list? | |
80 6.9. I heard AOL is combining ICQ and AIM, does that mean I can send | |
81 a message from an AIM account to an ICQ account and vice-versa? | |
82 6.10. Why can't I connect via either Oscar or TOC? | |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
83 6.11. English is not my native language, and some of my friends have |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
84 trouble seeing my IMs/I have trouble seeing my friends' IMs. How |
10473 | 85 do I use a native language character set with ICQ? |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
86 6.12. Can I set myself invisible? |
7842 | 87 |
88 7. IRC Protocol | |
89 | |
9618 | 90 7.1. How do I join a channel with the IRC plugin? |
91 7.2. Is there a way to make Gaim automatically identify me and/or join | |
7842 | 92 IRC chats on login? |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
93 7.3. Is it possible to change the user name that appears in |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
94 username@hostname? |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
95 7.4. How can I set/change my real name? |
7842 | 96 |
97 8. Jabber Protocol | |
98 | |
99 8.1. How do I choose which Jabber server to use? | |
100 8.2. How do I change my Jabber resource to be other than the default | |
8736 | 101 of "/Gaim"? |
7842 | 102 8.3. How do I register a new Jabber account? |
103 8.4. How do I use invisibility? | |
104 I've a buddy that I keep removing from my buddy list but the | |
105 8.5. entry keeps coming back every time I log in again! How can I stop | |
106 this? | |
107 8.6. Can I remove a buddy from my Jabber roster entirely? | |
108 8.7. What does "Cancel Presence Notification" do? | |
109 | |
8736 | 110 9. Y!M (Yahoo) Protocol |
7842 | 111 |
10473 | 112 9.1. I cannot connect to Yahoo! and get "Invalid Password" errors, or |
113 I'm using a version of Gaim older than 0.79! | |
114 9.2. I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why | |
115 doesn't Gaim have Yahoo's "Firewall with no proxy" option? | |
116 9.3. I blocked someone, but it doesn't seem to have worked. | |
117 9.4. Can I get a list of Yahoo! Chat rooms? What about non-US lists? | |
118 9.5. What protocol does Gaim use to connect to Yahoo!? | |
7842 | 119 |
120 10. MSN Protocol | |
121 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
122 10.1. Why are my file transfers so slow? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
123 10.2. I'm getting lots of "Already in Opposite list" errors on MSN, |
10473 | 124 why? |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
125 10.3. Is there a way to invite more than one person to an MSN chat? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
126 10.4. Is MSNP9 (MSN6) going to be supported? |
10473 | 127 Will I be able to use Gaim for MSN after October 15th 2003? |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
128 10.5. (The day they're preventing third party clients from |
10473 | 129 connecting) |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
130 10.6. I just upgraded Gaim and the MSN plugin will not load. Why? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
131 10.7. The MSN plugin won't load, but I have Mozilla NSS! |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
132 10.8. What does "MSN: S: 911 3" in the debug window mean when I |
10473 | 133 cannot connect to MSN? |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
134 10.9. How do I set an MSN avatar? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
135 10.10. What does "Has you" in the buddy tooltip mean? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
136 10.11. How do I set my MSN Friendly Name (the name other users see)? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
137 10.12. What does "Error reading from switchboard server" mean? |
7842 | 138 |
139 11. Gadu-Gadu Protocol | |
140 | |
141 11.1. What is Gadu-Gadu? | |
9618 | 142 11.2. Why doesn't it work right? |
7842 | 143 |
8736 | 144 12. Zephyr Protocol |
7842 | 145 |
8736 | 146 12.1. What is Zephyr? |
10473 | 147 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with |
8736 | 148 "Couldn't initialize zephyr". |
10473 | 149 12.3. Gaim isn't working, but I never got any other Zephyr client |
8736 | 150 working on this machine. |
10473 | 151 12.4. How do I use Zephyr from behind my firewall, or without |
152 recompiling with kerberos support if needed? | |
8736 | 153 |
10473 | 154 13. SILC Protocol |
8736 | 155 |
10473 | 156 13.1. What is SILC? |
9618 | 157 |
10473 | 158 14. Novell Protocol |
9618 | 159 |
10473 | 160 14.1. Are there any public servers for Novell? |
161 14.2. I can't seem to get it to work. | |
9618 | 162 |
10473 | 163 15. Scripts and Plugins |
9618 | 164 |
10473 | 165 15.1. How do I use perl scripts with Gaim? |
166 15.2. How do I compile a plugin for Gaim? | |
167 15.3. I have a plugin or perl script for Gaim that used to work, but | |
168 does not with the current version. | |
169 15.4. Where can I find documentation on writing plugins and Perl | |
7842 | 170 scripts? |
171 | |
10473 | 172 16. Development |
7842 | 173 |
10473 | 174 16.1. Can I help? |
175 16.2. Gaim never leaves a core file. | |
176 16.3. Where should I report bugs? | |
177 16.4. Where should I submit patches? | |
178 16.5. Did you guys reverse engineer it? | |
7842 | 179 |
10473 | 180 17. Misc. Questions |
8736 | 181 |
10473 | 182 17.1. Can I IM you guys? |
183 17.2. Hello? | |
7842 | 184 Can I give you money/hardware/other expensive things that can be |
10473 | 185 17.3. hocked for cash what with you all being students/ |
7842 | 186 full-time-workers and helping to produce this wonderful software |
187 instead of studying/sleeping? | |
10473 | 188 17.4. Does Gaim support secure instant messaging (encrypted IMs)? |
189 17.5. Why are the passwords in accounts.xml not encrypted? | |
190 17.6. What is gaim-remote? | |
191 17.7. When will the next version of Gaim be released? | |
192 17.8. What will the next version be? | |
193 17.9. So, can I look forward to mega-sexy super functionality with | |
194 Gaim? | |
7842 | 195 |
196 +------------------------------------------------------------------------------ | |
197 | 1. Compiling and Installing | |
198 +------------------------------------------------------------------------------ | |
199 | |
9618 | 200 1.1 What does "Gaim" stand for? |
10473 | 201 |
9618 | 202 For freedom! No, seriously, it doesn't stand for anything. It's our name and |
203 we're sticking to it. The two acceptable forms of capitalization are "Gaim" | |
204 and "gaim" (and not "GAIM"). | |
205 | |
206 1.2 Why can't I compile Gaim? | |
10473 | 207 |
8736 | 208 Make sure you have relatively recent versions of automake, autoconf, and |
209 gettext. HOWEVER, generally speaking, having the absolute newest of them is | |
210 not as good as having one version short of newest since we might not have | |
211 found work-arounds for the latest set of changes. Also, some versions of | |
212 automake require certain ranges of gettext versions, and we are utterly | |
213 unable to keep track of what versions will work with what other versions. | |
7842 | 214 |
8736 | 215 If you have Slackware < 9.1, you need to get non-slack packages for autoconf, |
7842 | 216 automake, gettext, and libtool. You also have to copy the contents of /usr/ |
217 local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware | |
218 and the auto* packages. | |
219 | |
220 *BSD users may also have problems with libtool and will also have to remove | |
221 the --no-verify from the configure script. | |
222 | |
8736 | 223 Having problems getting SSL and MSN working? See http://gaim.sf.net/ |
224 faq-ssl.php for distribution specific hints. | |
225 | |
9618 | 226 1.3 I'm trying to install Gaim, but it complains that I don't have |
7842 | 227 libgtkspell.so.0, from where can I get this? |
10473 | 228 |
7842 | 229 libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to |
230 provide the "Highlight misspelled words" feature. You can find an RPM of | |
231 gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific | |
232 RPM at gtkspell.sourceforge.net. | |
233 | |
9618 | 234 1.4 What do I need to use the SILC protocol? |
10473 | 235 |
9618 | 236 You need to install the SILC toolkit (http://silcnet.org/software/download/ |
237 toolkit/) and the Gaim SILC plugin. This plugin is generally provided as a | |
238 separate package (such as a gaim-silc RPM). If you're compiling yourself, see | |
239 the ./configure --help for specifying the SILC includes and libs. If you're | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
240 compiling an SRPM, use --with silc to build the gaim-silc RPM. |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
241 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
242 In Windows, the SILC toolkit is installed with Gaim. |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
243 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
244 Some distributions provide the SILC toolkit and include Gaim's SILC plugin in |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
245 their Gaim package. |
9618 | 246 |
247 1.5 Is there some way I can compile just Gaim, without all of these protocols? | |
10473 | 248 |
8736 | 249 Yeah. There are actually three ways to do it. |
7842 | 250 |
251 1. Use the --with-static-prpls option to ./configure along with | |
252 --disable-plugins. This will let you choose which protocols are compiled | |
253 in with Gaim, but you will not be able to use any other protocols or | |
254 plugins. | |
255 | |
256 You'll need to compile any protocols that you specified in | |
257 --with-static-prpls. Oscar and TOC are defaults. | |
258 | |
8736 | 259 2. Use the --with-dynamic-prpls option to ./configure |
260 | |
261 3. Change to the directories for the protocols you want to compile (e.g. src | |
7842 | 262 /protocols/jabber), and run make from there. Then after you've compiled |
263 all of them, change back to src/ and run make gaim. | |
264 | |
9618 | 265 1.6 I installed a new version of Gaim, but the about window says I'm still |
8736 | 266 using the old version. |
10473 | 267 |
268 If you compiled yourself, and you previously had an RPM or a Debian package | |
8736 | 269 installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should |
270 work. | |
7842 | 271 |
272 Likewise, if you want to use an RPM or deb and you have previously compiled | |
273 Gaim from source, you need to make uninstall to remove all Gaim files from / | |
274 usr/local. | |
275 | |
9618 | 276 1.7 Are the packages signed? If so, by who, and how can I get the key? |
10473 | 277 |
9618 | 278 Yes, all packages are signed. The signature for the tarball and bzip2 archive |
279 are provided by separate downloads. The RPMs we provide are signed by either | |
280 Ethan Blanton, Mark Doliner, or Christian Hammond. Usually the Mandrake and | |
281 Fedora Core 1 RPMs are signed by Mark Doliner and the Red Hat 8 and 9 RPMs | |
282 are signed by Ethan Blanton. The keys can be obtained from any key server. | |
283 http://pgp.mit.edu/ is popular. | |
284 | |
285 1.8 Can I use Gaim for GTK+1.2? | |
10473 | 286 |
8736 | 287 As of version 0.60, Gaim has been completely converted to using GTK+2.0. We |
288 really really really recommend using the most current version of Gaim and not | |
289 a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're | |
9618 | 290 afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.9, which is the |
291 last version of Gaim that used GTK+1.2. We should warn you though, this | |
292 version of Gaim hasn't had any new features since the middle of 2002, and | |
293 some protocols likely do not work. Also, the 0.59.x releases aren't | |
8736 | 294 breathtakingly beautiful. |
7842 | 295 |
9618 | 296 1.9 Can I run Gaim on IRIX? |
10473 | 297 |
8736 | 298 It has been done before. Please see http://sourceforge.net/forum/forum.php? |
299 thread_id=725839&forum_id=665 at our SourceForge Forum. | |
300 | |
10473 | 301 1.10 Can I run gaim on MacOSX? |
302 | |
303 Yes you can, but we do not provide a package for it. The reason being is that | |
304 to use gaim on MacOSX, you need to install an X server and gtk, which we are | |
305 not prepared to support. You can either compile gaim (and its dependencies) | |
306 yourself, or you can use the fink installer available from http://fink.sf.net | |
307 . If you would like a native aqua interface or a user-friendly installer, we | |
308 suggest trying Adium (http://www.adiumx.com/). | |
9618 | 309 |
10473 | 310 1.11 How do I apply the patch "something.diff"? |
311 | |
9618 | 312 Type patch -p0 < something.diff from inside the gaim directory. If that |
313 doesn't work, try patch -p1 < something.diff. | |
314 | |
10473 | 315 1.12 Why is gaim crashing when I start it? |
316 | |
8736 | 317 First of all make sure you are using the most recent version of Gaim. If you |
9618 | 318 still have problems, try the following: |
8736 | 319 |
10473 | 320 • Make sure only one version of Gaim is installed. "whereis gaim" can |
9618 | 321 sometimes be useful for determining this. |
10473 | 322 • "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same |
9618 | 323 terminal. |
10473 | 324 • If gaim is not crashing, but is just sitting there not displaying |
8736 | 325 anything, try turning off anything else that might be using the sound |
326 device (ie xmms) and then starting gaim. If this fixes the problem, it is | |
327 a libao issue, not a gaim issue, and can be worked around by the use of | |
328 esd or arts. | |
10473 | 329 • Try disabling or deleting any 3rd party plugins, especially anything |
8736 | 330 related to encryption. |
10473 | 331 • If you use 0.75 or higher on win32, try deleting tcl.dll. |
332 • If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto | |
8736 | 333 away preference from -1 to 0. |
9618 | 334 |
10473 | 335 1.13 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? |
336 | |
9618 | 337 Non-current versions have old bugs which may be fixed in the current |
338 version--that's why we make new releases. CVS is frequently unusable because | |
339 of changes in the code. Bugs are introduced during the development process | |
340 and are hopefully fixed before a release is made. | |
341 | |
10473 | 342 1.14 Why do you always say not to use CVS? |
343 | |
9618 | 344 That's a long story. For starters, see the previous question. It is often the |
345 case that Gaim CVS exhibits bad behavior due to features and bugfixes which | |
346 are in a transitory state or which are not yet well understood. These bad | |
347 behaviors range from the harmless (maybe a graphical glitch in a dialog box) | |
348 to the irritating (a particular protocol may not work), to the downright | |
349 damaging (recently a bug in CVS destroyed the user's buddy lists). While | |
350 behaviors like this are acceptable to some users (particularly developers, | |
351 who are used to such things), they tend to cause many Gaim CVS users to | |
352 contact Gaim developers and report the same (usually egregious) bug over and | |
353 over - using time which could be better spent fixing the bugs. | |
8736 | 354 |
9618 | 355 A second major point involves public resources - a CVS checkout is not a |
356 cheap operation. As many Sourceforge users are aware, at various points in | |
357 the recent past Sourceforge CVS has been less than pleasant to work with. | |
358 This is, of course, because Sourceforge hosts dozens and dozens of useful and | |
359 active projects which use CVS as a primary method of source code | |
360 collaboration. Unfortunately, when too many users are poking around in that | |
361 CVS just for the sake of poking around, it prevents other users who are | |
362 trying to do work to improve those very same projects from accomplishing | |
363 their tasks. It is better for the community if an enterprising individual | |
364 wishing to fix a particular bug she has seen can get to the code and create a | |
365 patch, even if this means that some users have to wait a few weeks for the | |
366 next release to see what new features it might hold. | |
367 | |
368 The third point is not a problem which has yet come up, but it is in the back | |
369 of the mind of the developers who bring you Gaim. As a third-party IM client, | |
370 Gaim is not a priority (and indeed may be an irritant) for the IM service | |
371 providers. We do our best to keep Gaim playing nice and being friendly on the | |
372 IM networks it uses; however, at times there are bugs in the protocol | |
373 support. If a few dozen people are using this buggy client, the IM providers | |
374 are not likely to go out of their way to do anything about it. However, if | |
375 hundreds of people are pointing an ill-behaved client at an IM server, the | |
376 server administrators may be forced to take action. (This is particularly | |
377 likely if the buggy behavior is damaging in some way.) Gaim releases | |
378 represent code which the gaim developers feel is relatively well-behaved and | |
379 stable. This includes not only the interface seen by Gaim users, but the | |
380 traffic seen by IM service providers. Gaim CVS bears no such guarantees. | |
381 | |
382 In short, there are a lot of good reasons to not use Gaim CVS if one does not | |
383 wish to develop Gaim, Gaim plugins, or a codebase which interacts with Gaim | |
384 in some intimate way. There are, however, only a few reasons to use Gaim CVS | |
385 outside of the above. Please weigh these things carefully and decide whether | |
386 you wish to use Gaim CVS for a good reason which furthers the community, or | |
387 for selfish reasons which are not entirely important. | |
8736 | 388 |
7842 | 389 +------------------------------------------------------------------------------ |
390 | 2. Using Gaim | |
391 +------------------------------------------------------------------------------ | |
392 | |
393 2.1 How do I register for a new account? | |
10473 | 394 |
7842 | 395 This depends on the protocol. |
396 | |
397 AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId= | |
398 snshomepage&authLev=1&mcState=initialized&createSn=1. | |
399 | |
9618 | 400 MSN (including Hotmail email): Go to http://registernet.passport.com/. |
401 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
402 MSN (using your own email address): Go to http://register.passport.net/. |
7842 | 403 |
404 Yahoo: Go to http://edit.yahoo.com/config/eval_register. | |
405 | |
406 Jabber: See the question How do I register a new Jabber account? below. | |
407 | |
9618 | 408 ICQ: Go to http://web.icq.com/register. |
409 | |
410 Gadu-Gadu: Use the official client to create an account. | |
9178 | 411 |
9618 | 412 Novell: See your Novell server administrator. |
413 | |
414 2.2 How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol? | |
10473 | 415 |
8736 | 416 Use the Account Editor (Tools->Accounts, or the Accounts button on the start |
9618 | 417 screen) to add the account of the appropriate messaging service. Use the |
418 checkbox in the account editor to sign online. | |
419 | |
420 2.3 How do I change the font Gaim uses? | |
10473 | 421 |
9618 | 422 The font preference in Gaim is used only for the formatting of outgoing |
423 messages. The display fonts used by the rest of Gaim are those specified by | |
424 GTK. To change this font you need to edit your ~/.gtkrc-2.0 file. If you need | |
425 help you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file. | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
426 On Windows, this file is located at C:\Documents and Settings\username |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
427 \.themes\Default\gtk-2.0\gtkrc. |
7842 | 428 |
10814
364a2ef907ae
[gaim-migrate @ 12468]
Luke Schierer <lschiere@pidgin.im>
parents:
10717
diff
changeset
|
429 You can also just switch to a different GTK+ theme. You can find GTK+ themes |
9618 | 430 (and information on using them) by visiting themes.freshmeat.net, |
431 art.gnome.org, or searching on Google. | |
432 | |
433 If you're having a problem with the font size used by a specific person, you | |
434 can try turning on the Ignore Font Sizes preference in Preferences->Message | |
435 Text. | |
436 | |
437 2.4 How do I make gaim use emacs-like keybindings? | |
10473 | 438 |
7842 | 439 You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http: |
440 //gaim.sf.net/gtkrc-2.0. | |
441 | |
9618 | 442 2.5 How do I use smiley themes? |
10473 | 443 |
8736 | 444 To select a theme, open Gaim's preferences to the "Smiley Themes" page and |
445 click on whichever theme you want to use. To install a theme, simply drag it | |
446 into the theme selector. You can find themes on the Gaim Smiley Themes (http: | |
447 //gaim.sf.net/themes.php) page. | |
7842 | 448 |
449 You can also install themes manually by uncompressing them to their own | |
450 directory in ~/.gaim/smileys/ | |
451 | |
452 2.6 Why are the status icons so big? | |
10473 | 453 |
7842 | 454 We believe that, by adding a second line of text to each buddy list entry, |
455 we're able to show more information about each buddy on the buddy list. The | |
456 'Big List,' as we call it, shows status text, idle time, and warning level | |
457 concisely and attractively. It shows more than one status "emblem" for each | |
458 buddy, indicating at the same time a mobile user who is away. Most | |
459 importantly, it puts the buddy icon in the list, making it far easier to | |
460 locate buddies within a large list where names are harder to pick out than | |
9618 | 461 images. Due to the increased usability of this interface, we have made it the |
7842 | 462 default. |
463 | |
464 We are aware that some people feel more comfortable using an interface more | |
9618 | 465 similar to IM clients they may have used in the past. The 'Big List' can be |
466 disabled by un-checking "Show buddy icons" in the Buddy List preferences. | |
7842 | 467 |
10473 | 468 2.7 Why do the emblems move around the status icon? |
469 | |
470 The four corners of the icon have different precedence. The lower-right is | |
471 the highest, lower-left is second-highest, etc. The most important emblem is | |
472 in the lower-right, always. When an AOL buddy is not away, the fact that [s] | |
473 he's an AOL user is the most important information shown in the icon. The | |
474 consistency is that the user can always look in the same place on the icon to | |
475 find out what he needs to know. Also, importantly, the lower-right corner | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
476 emblem is the only emblem that shows up when "Small list" is on, as only one |
10473 | 477 emblem would fit. |
9618 | 478 |
10473 | 479 2.8 How do I get sound to work correctly? |
480 | |
8736 | 481 Gaim uses libao to play sounds. Playing sounds directly through esound or |
482 arts is no longer supported. | |
7842 | 483 |
10473 | 484 `Libao is a cross-platform library that allows programs to output PCM audio |
8736 | 485 data to the native audio devices on a wide variety of platforms. It currently |
486 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound | |
487 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts | |
10473 | 488 (Analog Realtime Synthesizer). ' |
7842 | 489 |
8736 | 490 To compile Gaim with support for libao you need libao-devel and |
491 audiofile-devel. To use libao you need libao and audiofile. If you do not | |
492 wish to install these packages you can also just change your sound playing | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
493 method in preferences to Command and use esdplay %s or artsplay %s. |
7842 | 494 |
10473 | 495 2.9 How do I make Gaim use ALSA or OSS for playing sounds? What does the |
8736 | 496 "Automatic" option do? |
10473 | 497 |
8736 | 498 If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds. |
499 Choosing "ESD" or "Arts" forces libao to play sounds using that method, while | |
500 choosing "Automatic" lets it decide for itself. | |
7842 | 501 |
9618 | 502 If you choose "Automatic", you can create a file, either /etc/libao.conf or ~ |
8736 | 503 /.libao, and put one of the following lines in it: |
504 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
505 default_driver=alsa |
10473 | 506 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
507 default_driver=oss |
10473 | 508 |
8736 | 509 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
510 supported, depending on your platform and how libao was compiled. See also |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
511 man 5 libao.conf. |
7842 | 512 |
10473 | 513 2.10 Why does Gaim use the same WM_CLASS for every window? It makes it |
514 impossible to control window size and placement for the buddy list | |
515 separately from the conversations. | |
516 | |
8736 | 517 Both strings in the WM_CLASS property are supposed to be the same for all |
518 windows in the same instance of an application. ICCCM states that one is | |
519 meant to be the same for all instances of the application, the other is meant | |
520 to be unique to that instance of the application. ICCCM also states "If a | |
521 client has multiple windows with identical WM_CLASS and WM_NAME properties, | |
522 then it should provide a WM_WINDOW_ROLE property." | |
523 | |
10814
364a2ef907ae
[gaim-migrate @ 12468]
Luke Schierer <lschiere@pidgin.im>
parents:
10717
diff
changeset
|
524 GTK+ sets these WM_CLASS values for us so that they are unique for Gaim |
8736 | 525 instances, and the documentation for the gtk_window_set_wmclass function says |
9618 | 526 explicitly not to use it for anything else. Gaim uses the WM_WINDOW_ROLE hint |
527 to differentiate windows. If your window manager is having problems | |
528 differentiating between Gaim windows, please ensure that it uses the | |
529 WM_WINDOW_ROLE hint per the ICCCM. | |
7842 | 530 |
10473 | 531 2.11 I blocked someone accidentally, how can I unblock them? |
532 | |
533 See the "Privacy" option under the "Tools" menu of the Buddy List. | |
7842 | 534 |
10473 | 535 2.12 What is a "Buddy Pounce"? |
536 | |
7842 | 537 Gaim introduced buddy pounces a few releases before AOL came out with "Buddy |
538 Alerts." Despite this though, you could think of a buddy pounce as an Alert | |
539 and get an idea of the most minimal uses of a buddy pounce. In reality, a | |
540 buddy pounce is much like a macro, or a recorded action. When you set a | |
9618 | 541 pounce on someone, you choose from a number of events, such as sign on or |
7842 | 542 someone going away, and then you choose from a number of actions. These |
543 actions include everything from playing a sound (like an Alert would do) to | |
9618 | 544 sending a message to the person, to executing a command. This action will |
7842 | 545 occur the next time gaim detects the event, ie the next time the person in |
546 your buddy list who you have pounced signs on. | |
547 | |
10473 | 548 2.13 Where does gaim store its logs? |
549 | |
9618 | 550 On unix, they are in ~/.gaim/logs, on win32 they are in the $drive\Documents |
551 and Settings\user\Application Data\.gaim\logs directory. In either case, new | |
552 logs (new as of 0.73) are in subdirectories that correspond to protocol/ | |
553 yourscreenname/theirscreenname. | |
554 | |
10473 | 555 2.14 How can I see my own status with Gaim? |
556 | |
557 Currently the only supported method to see your own status is to add yourself | |
558 to your buddy list. This works with Aim, ICQ, Y!M, IRC, and some of the | |
559 others, and is mimiced by gaim for MSN and Jabber. | |
9618 | 560 |
10473 | 561 2.15 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that |
562 isn't IM-related? | |
563 | |
564 No, you can't. We get requests for this often, but Gaim is indeed a messaging | |
565 client. Aside from the capabilities each protocol may support, the Gaim | |
566 developers have no intention to turn Gaim into a multi-feature Internet | |
8736 | 567 client capable of doing everything under the sun. We also won't be helping to |
568 develop plugins to turn it into that. There are many Internet applications | |
569 available for Linux, Windows, or whatever operating system you use that would | |
9618 | 570 undoubtedly do a better job. |
7842 | 571 |
572 +------------------------------------------------------------------------------ | |
573 | 3. Features | |
574 +------------------------------------------------------------------------------ | |
575 | |
8736 | 576 3.1 Does Gaim support file transfer? |
10473 | 577 |
9618 | 578 Somewhat, yeah. As of 0.79 the following is supported: |
7842 | 579 |
10473 | 580 • Sending and receiving files on AIM (although it might be a bit buggy) |
581 • Sending and receiving files on IRC | |
582 • Sending and receiving files on Jabber | |
583 • Sending and receiving files on MSN | |
584 • Sending and receiving files on SILC | |
585 • Sending and receiving files on Yahoo (sending is limited to 1Mb) | |
8736 | 586 |
587 Most of the protocols themselves support file transfer, but Gaim has not been | |
588 written to support it yet. If you would like file transfer to work better or | |
589 be more complete, get CVS and submit a patch using the generic file transfer | |
590 API. | |
7842 | 591 |
8736 | 592 3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or |
7842 | 593 something? |
10473 | 594 |
8736 | 595 Yeah, Gaim supports what is called a system tray icon that conforms to the |
596 standards at www.freedesktop.org. This tray icon is supported by Windows, KDE | |
597 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System | |
598 Tray Icon" plugin by going to Preferences and then Plugins. | |
599 | |
600 If you're using Gnome you need to make sure that your panel has a | |
601 Notification Area on it. To add one, right click on the panel, select Add To | |
602 Panel->Utility->Notification Area. Gaim will insert the tray icon in any | |
7842 | 603 System Tray implementation that conforms to these standards, so feel free to |
8736 | 604 write one for your window manager of choice. |
7842 | 605 |
9618 | 606 Due to a flaw in these specs, KDE users may experience trouble with the |
607 background color of the docklet. There is unfortunately nothing we can do | |
608 about this. | |
609 | |
8736 | 610 3.3 What do those colors in the conversation tab mean? |
10473 | 611 |
612 • Red - A message is waiting for you | |
613 • Blue - Someone sent a message containing your name | |
614 • Green - The buddy is typing | |
615 • Yellow - The buddy began typing, and then stopped | |
616 • Gray - There has been a join or a part in that chat, or the buddy has | |
9618 | 617 signed off |
7842 | 618 |
8736 | 619 3.4 Will Gaim save my buddy list to the server? |
10473 | 620 |
9618 | 621 Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber, MSN, |
622 Novell and Yahoo!. | |
7842 | 623 |
8736 | 624 3.5 Can I import or export my buddy list? |
10473 | 625 |
8736 | 626 Sorry, no. Old versions of Gaim supported this, but new versions do not. All |
627 the code for saving and loading buddy lists was rewritten, and support for | |
628 importing and exporting buddy lists was never re-added. However, with all | |
629 major protocols storing their buddy lists on the server, this feature is less | |
630 useful today than in the past. | |
7842 | 631 |
8736 | 632 3.6 Does Gaim support animated smileys? |
10473 | 633 |
7842 | 634 Yes, as of version 0.70 Gaim supports animated smileys. |
635 | |
8736 | 636 3.7 Can I make Gaim group screen names by the person that owns them? You know, |
637 like Trillian's Meta Contacts? | |
10473 | 638 |
7842 | 639 Sure! Right click a buddy on your list and at the bottom of the menu click |
640 "Expand". Then just drag other screen names to the same person below it. When | |
641 you're done, click on the arrow to collapse them. When the contact is | |
642 collapsed, Gaim will select a buddy to display based on the status of the | |
643 buddies in the contact, and their order. | |
644 | |
10473 | 645 You may need to turn off the preference option to automatically expand |
646 Contacts in order to be able to edit an existing Contact. | |
647 | |
8736 | 648 3.8 How do I get the old logging back? |
10473 | 649 |
8736 | 650 The old logging was removed because it was deficient in many ways. There is |
9618 | 651 no way in Gaim itself to revert to the old logging, but the new logging is so |
8736 | 652 good you could implement something similar to the old logging as a plugin. |
653 | |
654 3.9 How can I convert my old logs to the new format? | |
10473 | 655 |
8736 | 656 It's not possible to perfectly convert from the old format to the new format |
657 because the old format is missing some information necessary to do that (eg. | |
658 which account the messages were sent from). | |
659 | |
660 It shouldn't be too difficult to do a rough conversion using a small script, | |
661 or using the old_logger_* functions in gaim itself. | |
662 | |
663 Peter Johnson has written a python script to do just this, it is available on | |
664 his website (at the bottom). | |
665 | |
7842 | 666 +------------------------------------------------------------------------------ |
667 | 4. ICQ Protocol | |
668 +------------------------------------------------------------------------------ | |
669 | |
670 4.1 How do I use ICQ? | |
10473 | 671 |
8736 | 672 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use |
9618 | 673 it, simply put your account number in the "Screen Name" box and your password |
674 in the "Password" box. Leave the server settings set to the default | |
8736 | 675 (login.oscar.aol.com and port 5190). |
7842 | 676 |
8736 | 677 4.2 Can I send SMS messages? |
10473 | 678 |
8736 | 679 Kind of. See our answer to this for the AIM/ICQ Protocol. |
7842 | 680 |
681 +------------------------------------------------------------------------------ | |
682 | 5. TOC Protocol | |
683 +------------------------------------------------------------------------------ | |
684 | |
685 5.1 What is the TOC protocol? | |
10473 | 686 |
9618 | 687 It's an AIM protocol used by Quick Buddy and AIM Express. It's recommended |
688 that you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol | |
689 instead. We keep TOC around in case OSCAR ever stops working. However, we are | |
690 not actively supporting this code, and no longer distribute it in binaries. | |
7842 | 691 |
692 +------------------------------------------------------------------------------ | |
8736 | 693 | 6. AIM/ICQ (OSCAR) Protocol |
7842 | 694 +------------------------------------------------------------------------------ |
695 | |
8736 | 696 6.1 Can I set my profile? |
10473 | 697 |
9618 | 698 Yes you can. Go to Tools->Account Actions |
8736 | 699 |
700 6.2 Can I set a buddy icon? | |
10473 | 701 |
7842 | 702 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and |
703 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the | |
704 full path to the image you wish to use in the box labeled "Buddy Icon File." | |
705 The file must be below 4KB. It can have any dimensions, and can be in any | |
706 format. However, if you wish Windows users to see it, it must be in a format | |
707 Windows understands, such as .bmp, .gif, and .jpg. | |
708 | |
8736 | 709 6.3 Some of my buddies are not showing up as online, why is that? |
10473 | 710 |
7842 | 711 AOL has set a limit for the maximum number of people you can have in your |
8736 | 712 buddy list. This number is currently 200. If you don't think you are anywhere |
713 near that limit, it is possible that your server-stored buddy list is | |
714 corrupt. | |
715 | |
9618 | 716 If you think this might be the case, you can try signing on with an official |
717 AIM program from AOL. This will usually correct any problems with the list. | |
7842 | 718 |
8736 | 719 6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"? |
10473 | 720 |
7842 | 721 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need |
722 to pass the entire URI to the gaim-remote program (included with gaim). To do | |
723 this with Gnome 2, run gnome-file-types-properties or "File Types and | |
724 Programs" from the preferences menu. Add a service with protocol "aim" and | |
725 set the program to gaim-remote uri "%s". This will make AIM URIs work in | |
10473 | 726 Galeon 2. Also, not all types of AIM URI's are supported. The ones that are |
7842 | 727 supported are goim, addbuddy, and gochat. |
728 | |
8736 | 729 You'll need the "Remote Control" plugin loaded for this to work. |
730 | |
7842 | 731 If you use wingaim, this will not work as gaim-remote has not yet been ported |
732 over. | |
733 | |
9618 | 734 6.5 I just changed my buddy icon, and I can't see the new one. |
10473 | 735 |
9618 | 736 First, try IMing yourself a few times. Buddy icons are checked when you IM |
737 people, so depending on the protocol, that may work. If it still doesn't | |
738 update, check the file size (buddy icons must be smaller than 4kb) and the | |
739 image size (it should be 48x48 or 50x50 in most cases). Also, check the file | |
740 type. GIF or JPEG images are best supported; most other formats do not work | |
741 at all. If all of that checks out and it still doesn't work, and you're sure | |
742 the protocol supports it, try restarting Gaim. | |
8736 | 743 |
9618 | 744 6.6 Does Gaim support DirectIM and IM Image? |
10473 | 745 |
9618 | 746 Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not |
747 working for you, make sure that at least one person is not behind a firewall. | |
9178 | 748 |
9618 | 749 6.7 Can I send SMS messages? |
10473 | 750 |
8736 | 751 Yep, just send an IM to the person's phone number. For example, if the phone |
9618 | 752 number is (919) 555-1234, you would IM the screen name +19195551234 We think |
753 this should work for countries with a country code of 1 (the United States | |
754 and Canada). | |
7842 | 755 |
8736 | 756 Sending SMS messages using "the ICQ method" is not yet supported. |
7842 | 757 |
9618 | 758 6.8 Can I add SMS numbers to my buddy list? |
10473 | 759 |
7842 | 760 Not currently. This functionality has been broken since around September |
761 2003. There is no ETA for when it will be fixed. | |
762 | |
9618 | 763 6.9 I heard AOL is combining ICQ and AIM, does that mean I can send a message |
7842 | 764 from an AIM account to an ICQ account and vice-versa? |
10473 | 765 |
7842 | 766 Yes, AOL is slowly letting the two messaging networks interoperate with each |
767 other. Messaging between the two protocols works as long as the receiver of | |
768 the message supports it. Gaim 0.60 supports sending and receiving messages | |
769 between AIM and ICQ, but the person receiving the message must support this. | |
770 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM | |
771 version 5.2.3139 supports receiving messages from ICQ users. It is unknown if | |
772 earlier versions of Windows AIM support this. Windows ICQ build 3800 does not | |
773 support receiving messages from AIM users. Windows ICQ Lite builds 1150 and | |
774 later support receiving messages from AIM users and sending messages to AIM | |
775 users. MacAIM versions 4.6 beta, build 1.1131 and newer support sending and | |
776 receiving messages to and from ICQ users. | |
777 | |
778 The same clients that support receiving messages from the alternate messaging | |
779 network will also show up in buddy lists of people using the alternate | |
780 network. This means that if you can message an ICQ user from an AIM account, | |
781 then the ICQ user will also show up in your AIM buddy list. So an AIM user | |
782 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list. | |
783 | |
9618 | 784 6.10 Why can't I connect via either Oscar or TOC? |
10473 | 785 |
7842 | 786 If you are using Linux, your kernel may be using a network option called |
787 "ECN". It seems that the AOL servers are currently dropping packets marked as | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
788 "ECN-capable". In order to turn this off, run the command |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
789 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
790 echo 0 > /proc/sys/net/ipv4/tcp_ecn |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
791 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
792 as root, or (if your distribution supports it) put the line |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
793 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
794 net.ipv4.tcp_ecn = 0 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
795 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
796 in the file /etc/sysctl.conf. |
7842 | 797 |
10473 | 798 6.11 English is not my native language, and some of my friends have trouble |
799 seeing my IMs/I have trouble seeing my friends' IMs. How do I use a | |
800 native language character set with ICQ? | |
801 | |
802 Gaim 0.82 and higher allow you to specify a character encoding to use when | |
803 conversing with ICQ users. Use the account editor to set this encoding. | |
804 | |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
805 6.12 Can I set myself invisible? |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
806 |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
807 Yes. Go to Tools->Away->account->Invisible. |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
808 |
7842 | 809 +------------------------------------------------------------------------------ |
810 | 7. IRC Protocol | |
811 +------------------------------------------------------------------------------ | |
812 | |
9618 | 813 7.1 How do I join a channel with the IRC plugin? |
10473 | 814 |
7842 | 815 First create the account, then sign on. After you have signed on, you can use |
816 File->Join A Chat on the buddy list to join a channel. In any window, either | |
817 a conversation or a chat, in which your IRC user is the sender, you can also | |
818 use /join to connect to a new channel. | |
819 | |
9618 | 820 7.2 Is there a way to make Gaim automatically identify me and/or join IRC |
7842 | 821 chats on login? |
10473 | 822 |
7842 | 823 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. |
10473 | 824 Do not include "/msg nickserv" as part of the message to send. |
7842 | 825 |
826 In version 0.64 or higher, you can add a chat to your buddy list, right click | |
10473 | 827 it, and tell Gaim to auto-join it. |
7842 | 828 |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
829 7.3 Is it possible to change the user name that appears in username@hostname? |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
830 |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
831 Yes. Go to Tools->Accounts. Select your IRC account and click Modify. Expand |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
832 the Show more options section. Enter a name in the Username field. |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
833 |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
834 7.4 How can I set/change my real name? |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
835 |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
836 Go to Tools->Accounts. Select your IRC account and click modify. Expand the |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
837 Show more options section. Enter a name in the Real name field. |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
838 |
7842 | 839 +------------------------------------------------------------------------------ |
840 | 8. Jabber Protocol | |
841 +------------------------------------------------------------------------------ | |
842 | |
843 8.1 How do I choose which Jabber server to use? | |
10473 | 844 |
7842 | 845 The Jabber server name is part of your Jabber I.D., such as |
846 somebody@server.name. So when entering your Jabber "screen name", the server | |
847 is specified as part of your JID. | |
848 | |
849 8.2 How do I change my Jabber resource to be other than the default of "/ | |
8736 | 850 Gaim"? |
10473 | 851 |
7842 | 852 When you create your account in Gaim, simply append the desired resource |
853 identifier to your Jabber I.D. For example: somebody@server.name/resource | |
854 | |
855 8.3 How do I register a new Jabber account? | |
10473 | 856 |
7842 | 857 As of version 0.52 and up: |
858 | |
859 1. Click "Tools->Accounts->Add" | |
860 2. Select "Jabber" for the protocol. | |
861 3. Fill in screen name and password as you normally would. THIS IS A | |
862 REQUIRED STEP | |
863 4. Check the "Register with server" check-box | |
864 5. Click "OK". | |
865 | |
866 Note: You are strongly recommended to check the "Remember password" check-box | |
867 as well, as Gaim presently does no password verification. So if you don't | |
868 type in what you thought you did, you're hosed. | |
869 | |
870 8.4 How do I use invisibility? | |
10473 | 871 |
7842 | 872 Jabber invisibility support is available in Gaim version 0.60 and later. |
873 | |
874 There are two ways to use Jabber invisibility: on a per-buddy and on a | |
875 per-server basis. | |
876 | |
877 To use per-buddy invisibility: right-click on the buddy on the Online buddy | |
878 list and select "Temporarily Hide From." You will appear to that buddy to be | |
879 off-line. To make yourself seen by that buddy again: right-click on the buddy | |
880 and select "Un-hide From." Note that the menu changes based on whether you're | |
881 currently invisible to that buddy or not. | |
882 | |
883 The "Temporarily" part is a dead give-away. Your invisibility to that | |
884 buddy will last only until the next time you log on or until you set | |
885 server invisibility (discussed next) on and off. | |
886 | |
887 To use per-server invisibility: click "Tools -> Away," select the Jabber | |
888 server login for the server upon which you wish to become invisible (if | |
889 necessary) and select "Invisible." To become visible again: select anything | |
890 else from that same menu (such as "Online"), or set your away status or log | |
891 off the server and back on again. | |
892 | |
893 You can set yourself invisible per-server and subsequently make yourself | |
894 visible to selected buddies only. | |
895 | |
896 Gaim currently does not retain invisibility settings between logins, just as | |
897 it doesn't currently retain "away" status. | |
898 | |
899 8.5 I've a buddy that I keep removing from my buddy list but the entry keeps | |
900 coming back every time I log in again! How can I stop this? | |
10473 | 901 |
9618 | 902 With Gaim 0.60 or later, it might be continuing to import the old buddy |
8736 | 903 lists. Remove ~/.gaim/*.blist - these are no longer used, the buddy list is |
904 now stored in ~/.gaim/blist.xml | |
7842 | 905 |
906 8.6 Can I remove a buddy from my Jabber roster entirely? | |
10473 | 907 |
9618 | 908 With Gaim 0.60 or later, the deletion code will do this. Gaim currently does |
909 not retain invisibility settings between logins, just as it doesn't currently | |
910 retain "away" status. | |
7842 | 911 |
912 8.7 What does "Cancel Presence Notification" do? | |
10473 | 913 |
7842 | 914 This selection, available in Gaim version 0.60 and later, and found by |
9618 | 915 right-clicking on a buddy entry in the buddy list, prevents that Jabber I.D. |
916 from receiving future presence notifications when you log on to the server. | |
7842 | 917 |
918 After you do this, that buddy will have to re-request a subscription to your | |
919 presence (and you will have to approve it) for them to again see you on-line. | |
920 | |
921 +------------------------------------------------------------------------------ | |
8736 | 922 | 9. Y!M (Yahoo) Protocol |
7842 | 923 +------------------------------------------------------------------------------ |
924 | |
10473 | 925 9.1 I cannot connect to Yahoo! and get "Invalid Password" errors, or I'm using |
926 a version of Gaim older than 0.79! | |
927 | |
928 Make sure you have at least 0.79. | |
929 | |
930 9.2 I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why doesn't | |
931 Gaim have Yahoo's "Firewall with no proxy" option? | |
932 | |
933 Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping the | |
934 YMSG protocol inside HTTP. Gaim currently doesn't support doing this. | |
935 | |
936 Gaim does support changing the port it connects to. Try changing the | |
937 Pager Port in the Account editor under "Show more options". Ports known to | |
938 work are: 20, 23, 25, 80, 119, 5050, 8001, and 8002. While this doesn't work | |
939 for as many people as actually tunneling through the HTTP protocol would, it | |
940 helps many users. | |
941 | |
942 9.3 I blocked someone, but it doesn't seem to have worked. | |
943 | |
944 As of 0.81, this is a known bug in our Yahoo code. We're not sure what | |
945 exactly is wrong, but it seems to fail most often when automatically removing | |
946 the buddy from your buddy list at the same time it blocks them. It also | |
947 always seems to fail if Gaim already thinks the buddy is blocked, and you try | |
948 to block them again. | |
949 | |
950 We suggest manually removing Yahoo! buddies before attempting to block them. | |
951 For buddies which Gaim reports are blocked but which are not, unblocking them | |
952 and reblocking them from the Tools->Privacy dialog will often get things | |
953 working. | |
954 | |
955 9.4 Can I get a list of Yahoo! Chat rooms? What about non-US lists? | |
956 | |
957 Tools->Room List will let you list available Yahoo! Chat rooms. Yahoo! does | |
958 support hidden and invite-only rooms. If you know the name of the room you | |
959 wish to join, and it's not invite only, you can join it via Buddies->Join a | |
960 Chat. You can also create a chat room this way, although we don't support | |
961 setting the hidden or invite-only type settings. | |
9618 | 962 |
10473 | 963 To get a non-US room list, you'll need to change the Chat Room List Url in |
964 the account editor, under "Show more options". By default this field contains | |
965 "http://insider.msg.yahoo.com/ycontent/". You can add a country code prefix | |
966 to the url to fetch the list for another country. For example, for the German | |
967 list, you would use "http://de.insider.msg.yahoo.com/ycontent/". | |
968 | |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
969 This has recently stopped working, we are investigating alternatives. |
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
970 |
10473 | 971 The list of known country codes for this url is: |
972 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
973 • aa => Asia |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
974 • ar => Argentina |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
975 • au => Australia |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
976 • br => Brazil |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
977 • ca => Canada |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
978 • cf => Central African Republic |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
979 • cn => China |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
980 • de => Germany |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
981 • dk => Denmark |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
982 • es => Spain |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
983 • fr => France |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
984 • hk => Hong Kong |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
985 • in => India |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
986 • it => Italy |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
987 • kr => Korea, Republic of |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
988 • mx => Mexico |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
989 • no => Norway |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
990 • se => Sweden |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
991 • sg => Singapore |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
992 • tw => Taiwan |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
993 • uk => United Kingdom |
10473 | 994 |
995 9.5 What protocol does Gaim use to connect to Yahoo!? | |
996 | |
997 Normally Gaim uses the YMSG protocol, which is the same protocol that the | |
998 official Yahoo! clients use. If an attempt to login returns the "Invalid | |
999 Password" error code, Gaim automatically tries to log in using the "Web | |
1000 Messenger" method. This method still uses the YMSG protocol, but | |
1001 authenticates differently, and connects to a different server. | |
1002 | |
1003 While in Web Messenger mode, several things work differently or not at all. | |
1004 Adding, moving, and removing buddies doesn't work, and the only available | |
1005 statuses are "Available" and "Invisible". In addition, the Yahoo! server | |
1006 seems to ignore all Yahoo! Chat related packets. For this reason, we use the | |
1007 YCHT protocol to join Yahoo! Chat rooms while connected using the Web | |
1008 Messenger method. | |
7842 | 1009 |
1010 +------------------------------------------------------------------------------ | |
1011 | 10. MSN Protocol | |
1012 +------------------------------------------------------------------------------ | |
1013 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1014 10.1 Why are my file transfers so slow? |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1015 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1016 Gaim only supports tranferring files over MSN via the MSN servers. This means |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1017 all your data is sent to an MSN server and then forwarded to the person at |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1018 the other end of the transfer. It is unknown whether we will support true |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1019 peer to peer file transfer over MSN. |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1020 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1021 10.2 I'm getting lots of "Already in Opposite list" errors on MSN, why? |
10473 | 1022 |
9618 | 1023 The reason this happens is because you have a screen name in both your permit |
7842 | 1024 list and your deny list. There are two ways to fix this: the correct way and |
10473 | 1025 the quick way. The correct way is to go to Tools->Privacy, and manually scan |
1026 the list and remove the duplicate entries. The quick way is to remove the | |
1027 blist.xml file from the ~/.gaim directory. Be aware that this contains your | |
1028 buddy list for all accounts, and also stores the "Contact" grouping of | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1029 Buddies. |
7842 | 1030 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1031 10.3 Is there a way to invite more than one person to an MSN chat? |
10473 | 1032 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1033 Yes. Right click a buddy on your list and choose "Initiate Chat". In the |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1034 conversation window that appears, choose "Invite" from the "Conversation" |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1035 menu to invite another user. When the conversation framework gets another |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1036 rewrite, it is possible that this will be simplified. |
7842 | 1037 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1038 10.4 Is MSNP9 (MSN6) going to be supported? |
10473 | 1039 |
7842 | 1040 MSNP9 support has existed in Gaim since 0.69. However, at this point, |
10473 | 1041 features such as custom smileys aren't yet implemented. |
7842 | 1042 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1043 10.5 Will I be able to use Gaim for MSN after October 15th 2003? (The day |
8736 | 1044 they're preventing third party clients from connecting) |
10473 | 1045 |
7842 | 1046 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported |
8736 | 1047 after October 15th 2003. |
7842 | 1048 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1049 10.6 I just upgraded Gaim and the MSN plugin will not load. Why? |
10473 | 1050 |
7842 | 1051 You did not compile with SSL support, or the SSL plugin failed to load. As of |
10473 | 1052 protocol version 9, the MSN protocol requires the use of SSL, which Gaim |
7842 | 1053 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla |
1054 project. Install one or both of these and recompile Gaim, and see the next | |
1055 question. | |
1056 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1057 10.7 The MSN plugin won't load, but I have Mozilla NSS! |
10473 | 1058 |
7842 | 1059 Some distributions, including Slackware, install Mozilla NSS to a |
1060 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/ | |
1061 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to | |
1062 the file, and run ldconfig as root. Then re-run configure and recompile Gaim. | |
1063 You may also need to specify where the include file are for NSS and NSPR, see | |
1064 ./configure --help for the options. | |
1065 | |
1066 Mozilla 1.5 has a broken .pc file and does not install the necessary .h | |
1067 files, and so will not be detected. | |
1068 | |
10473 | 1069 See http://gaim.sf.net/faq-ssl.php on getting SSL to work with Gaim. |
8736 | 1070 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1071 10.8 What does "MSN: S: 911 3" in the debug window mean when I cannot connect |
10473 | 1072 to MSN? |
1073 | |
1074 See http://gaim.sf.net/911.txt. | |
1075 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1076 10.9 How do I set an MSN avatar? |
10473 | 1077 |
1078 Gaim calls these Buddy Icons. Go to Tools->Accounts and click to Modify your | |
1079 MSN account. You can drag and drop a file to the resulting dialog, or use the | |
1080 Open button. | |
9618 | 1081 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1082 10.10 What does "Has you" in the buddy tooltip mean? |
10473 | 1083 |
1084 It shows you if that MSN user has added you to his/her buddy list. "Has you: | |
1085 No" does not mean you can't talk to that person. | |
1086 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1087 10.11 How do I set my MSN Friendly Name (the name other users see)? |
10473 | 1088 |
1089 In the Buddy List window, go to Tools->Account Actions->account->Set Friendly | |
1090 Name. | |
1091 | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1092 10.12 What does "Error reading from switchboard server" mean? |
10473 | 1093 |
1094 We haven't fully figured that out yet, but even Microsoft's client seems to | |
1095 get similar errors, although with less frequency than we do. See Bug 1060205 | |
1096 for further information. | |
7842 | 1097 |
1098 +------------------------------------------------------------------------------ | |
1099 | 11. Gadu-Gadu Protocol | |
1100 +------------------------------------------------------------------------------ | |
1101 | |
1102 11.1 What is Gadu-Gadu? | |
10473 | 1103 |
7842 | 1104 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at |
8736 | 1105 www.gadu-gadu.pl (website in Polish). |
7842 | 1106 |
9618 | 1107 11.2 Why doesn't it work right? |
10473 | 1108 |
9618 | 1109 We have not had a Gadu-Gadu maintainer in some time and are currently |
1110 struggling to keep this protocol functional. If you have any problems, you | |
1111 will need to submit a patch for them, as we are unlikely to have much luck | |
1112 fixing it. If things get too bad, we will be forced to remove this protocol | |
1113 from the default builds. | |
1114 | |
7842 | 1115 +------------------------------------------------------------------------------ |
8736 | 1116 | 12. Zephyr Protocol |
7842 | 1117 +------------------------------------------------------------------------------ |
1118 | |
8736 | 1119 12.1 What is Zephyr? |
10473 | 1120 |
8736 | 1121 Zephyr is an IM protocol developed at MIT for use with Project Athena. Its |
1122 features include Kerberos IV authentication, multi-level chats (aka | |
1123 "subscriptions"). You're probably using this because your college/employer/ | |
1124 organization uses it as a local IM/chat system. If not, you probably don't | |
1125 have a server to connect to. | |
1126 | |
10473 | 1127 12.2 Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't |
8736 | 1128 initialize zephyr". |
10473 | 1129 |
8736 | 1130 Your site might require the use of Kerberos 4 for authentication, though few |
10473 | 1131 prepackaged Gaim binaries use Kerberos. One solution is to compile Gaim with |
1132 the --with-krb4 flag to point to the location of your Kerberos 4 devel files, | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1133 usually one of /usr, /usr/local, or /usr/athena, e.g. ./configure --with-krb4 |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1134 =/path/to/kerberosIV |
8736 | 1135 |
10473 | 1136 12.3 Gaim isn't working, but I never got any other Zephyr client working on |
8736 | 1137 this machine. |
10473 | 1138 |
1139 You need to have zhm (which comes with the standard Zephyr distribution) | |
1140 installed, and running, and pointed at your Zephyr servers. e.g. | |
8736 | 1141 |
1142 zhm z1.example.com z2.example.com z3.example.com | |
1143 | |
10473 | 1144 Alternatively, there might be a firewall or a NAT between you and the Zephyr |
1145 servers. Zephyr generally doesn't work in an environment where incoming | |
1146 connections cannot be made to arbitrary UDP ports. | |
1147 | |
1148 12.4 How do I use Zephyr from behind my firewall, or without recompiling with | |
1149 kerberos support if needed? | |
1150 | |
1151 You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a machine | |
1152 that is behind a firewall or NAT. First, make sure that tzc is installed and | |
1153 working on the remote machine. The best version of tzc to use can be found | |
1154 http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/ | |
1155 tzc-cclub_001-3.tar.gz. Second, make sure that you can make a passwordless | |
1156 ssh connection to the remote machine and get kerberos 4 tickets. Then, click | |
1157 on "Show more options", enable "Use tzc", and set the tzc command to | |
1158 | |
1159 /path/to/ssh username@hostname /path/to/tzc -e "%s" | |
1160 | |
1161 Alternately, if you have tzc working on your machine, you can enable "Use | |
1162 tzc", and set the tzc command to | |
1163 | |
1164 /path/to/tzc -e "%s" | |
8736 | 1165 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1166 |
8736 | 1167 +------------------------------------------------------------------------------ |
10473 | 1168 | 13. SILC Protocol |
8736 | 1169 +------------------------------------------------------------------------------ |
1170 | |
10473 | 1171 13.1 What is SILC? |
1172 | |
9618 | 1173 SILC is an open protocol designed from the ground up with security in mind. |
1174 It is, or should be, the protocol of choice for the paranoid. See http:// | |
1175 www.silcnet.org for more details. | |
1176 | |
1177 +------------------------------------------------------------------------------ | |
10473 | 1178 | 14. Novell Protocol |
7842 | 1179 +------------------------------------------------------------------------------ |
1180 | |
10473 | 1181 14.1 Are there any public servers for Novell? |
1182 | |
9618 | 1183 Not really. This protocol is designed to connect to a Novell GroupWise server |
1184 running on a corporate LAN. | |
1185 | |
10473 | 1186 14.2 I can't seem to get it to work. |
1187 | |
9618 | 1188 Novell tells us that this protocol plugin will only work with either the |
1189 GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or | |
1190 higher) server for NetWare and Windows. In addition, the server must be | |
1191 secure (SSL enabled). If you have any trouble, see the FAQ question about | |
1192 submitting bugs, and they will be forwarded to Novell, who have been kind | |
1193 enough to continue active maintenance to the protocol plugin code they | |
1194 provided us. | |
1195 | |
1196 +------------------------------------------------------------------------------ | |
10473 | 1197 | 15. Scripts and Plugins |
9618 | 1198 +------------------------------------------------------------------------------ |
1199 | |
10473 | 1200 15.1 How do I use perl scripts with Gaim? |
1201 | |
8736 | 1202 Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim, |
1203 and load the perl script by checking the check box next to its name on the | |
1204 Plugins page in preferences. | |
7842 | 1205 |
10473 | 1206 15.2 How do I compile a plugin for Gaim? |
1207 | |
8736 | 1208 To compile a plugin for Gaim, you must have Gaim's source code. To download |
1209 Gaim's source code, get the most recent tarball from http:// | |
1210 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and | |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1211 untar it with the command: tar zxvf filename where filename is the file you |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1212 downloaded. |
7842 | 1213 |
8736 | 1214 After you have a Gaim source code tree: |
7842 | 1215 |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1216 1. Change to the resulting directory and run the command: ./configure This |
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1217 will create the necessary make files. |
7842 | 1218 2. Move the plugin you wish to compile into the plugins/ directory in the |
1219 Gaim source code tree. | |
1220 3. Change to the plugins/ directory. | |
10473 | 1221 4. On Unix/Linux Type: |
1222 | |
7842 | 1223 make name.so |
10473 | 1224 |
1225 where the name of the file you wish to compile is name.c. | |
1226 | |
1227 On Win32 Type: | |
1228 | |
1229 make -f Makefile.mingw name.dll | |
1230 | |
7842 | 1231 where the name of the file you wish to compile is name.c. |
1232 | |
1233 Note well the difference in the extensions. If you type make name.c | |
1234 instead of name.so, it won't work. | |
1235 | |
1236 5. After make finishes, you can move the plugin to a place that is more | |
1237 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by | |
1238 compiling it yourself, $prefix is /usr/local by default. Otherwise, | |
1239 $prefix is /usr. | |
1240 | |
10473 | 1241 15.3 I have a plugin or perl script for Gaim that used to work, but does not |
1242 with the current version. | |
1243 | |
1244 The plugin and perl script API has changed several times, which means plugins | |
1245 and perl scripts must be modified in order to work. The plugin or perl script | |
8736 | 1246 must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must |
10473 | 1247 implement the new API, as documented by the make docs command from the root |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
1248 of the Gaim source code tree. This will generate html documentation in the |
10473 | 1249 doc/html directory. Also note that plugins and perl scripts are now |
1250 controlled from preferences. | |
8736 | 1251 |
10473 | 1252 15.4 Where can I find documentation on writing plugins and Perl scripts? |
1253 | |
7842 | 1254 If you look in the plugins/ directory in the Gaim source, you should see a |
8736 | 1255 HOWTO file with some details for C plugins. Also be sure to check out our |
1256 online documentation (http://gaim.sf.net/api/index.html). Be especially sure | |
1257 to look at the Related Pages, which lists all of Gaim's signals, as well as a | |
1258 nice perl script HOWTO. | |
7842 | 1259 |
8736 | 1260 This documentation can be generated directly from the Gaim source by running |
1261 make docs. You will need doxygen and graphviz dot installed for this to work. | |
7842 | 1262 |
1263 +------------------------------------------------------------------------------ | |
10473 | 1264 | 16. Development |
7842 | 1265 +------------------------------------------------------------------------------ |
1266 | |
10473 | 1267 16.1 Can I help? |
1268 | |
9618 | 1269 But of course. Just find something that's bugging you and fix it. There are a |
1270 slew of a bug reports in Gaim's bug report tracker - you could pick one and | |
8736 | 1271 try to tackle it and submit a patch. You could also help with general bug |
1272 triage by going through the bug reports and leaving comments such as "this | |
1273 has been fixed" or "this is a duplicate of bug #12345." As always, make sure | |
1274 you follow the same coding style used in Gaim, and make sure you don't break | |
1275 the core/UI split. | |
1276 | |
10473 | 1277 16.2 Gaim never leaves a core file. |
1278 | |
8736 | 1279 On most installs core files are limited in size to 0 bytes, and are therefore |
1280 not created. To rectify this situation, add ulimit -c unlimited to your | |
1281 startup scripts (~/.bash_profile is a good place) or run it manually in a | |
10473 | 1282 terminal before starting Gaim from that terminal. You can also run Gaim |
8736 | 1283 directly in gdb with gdb gaim. |
1284 | |
10473 | 1285 16.3 Where should I report bugs? |
1286 | |
1287 http://gaim.sf.net/bug.php. | |
7842 | 1288 |
10473 | 1289 16.4 Where should I submit patches? |
1290 | |
1291 http://gaim.sf.net/patches.php. | |
7842 | 1292 |
10473 | 1293 16.5 Did you guys reverse engineer it? |
1294 | |
7842 | 1295 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have |
1296 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were | |
9618 | 1297 reverse engineered by other people. Novell was provided by Novell, and SILC |
1298 was written by one of the protocol's developers. | |
7842 | 1299 |
1300 +------------------------------------------------------------------------------ | |
10473 | 1301 | 17. Misc. Questions |
7842 | 1302 +------------------------------------------------------------------------------ |
1303 | |
10473 | 1304 17.1 Can I IM you guys? |
1305 | |
8736 | 1306 Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php) |
7842 | 1307 page! |
1308 | |
10473 | 1309 17.2 Hello? |
1310 | |
7842 | 1311 We don't know how to answer this question. Stop asking it. |
1312 | |
10473 | 1313 17.3 Can I give you money/hardware/other expensive things that can be hocked |
7842 | 1314 for cash what with you all being students/full-time-workers and helping |
1315 to produce this wonderful software instead of studying/sleeping? | |
10473 | 1316 |
7842 | 1317 No. We're completely fool-hardy and won't accept any gratuities with no |
1318 strings attached for just being good guys. That and we'd have to share with | |
1319 everyone who has submitted patches. ;-) | |
1320 | |
10473 | 1321 17.4 Does Gaim support secure instant messaging (encrypted IMs)? |
1322 | |
1323 Short answer: Yes, use the SILC protocol. | |
10927
4d87f2dccb6d
[gaim-migrate @ 12703]
Gary Kramlich <grim@reaperworld.com>
parents:
10814
diff
changeset
|
1324 Long Answer (for other protocols): Not natively. Doing secure instant |
10473 | 1325 messaging right is a big deal and requires, among other things, an |
1326 authentication scheme. Simply encrypting your data stream without verifying | |
1327 the party with whom you are chatting is not secure in any way; some other | |
1328 clients offer options like this, but we feel that such measures instill a | |
1329 false sense of security that is more harmful than helpful. | |
7842 | 1330 |
8736 | 1331 There are a number of 3rd party plugin developers working on developing a |
1332 secure IM framework, the better ones using the GnuPG and the OpenPGP trust | |
1333 model for authentication. If you are serious about secure instant messaging, | |
1334 read the documentation on the "web of trust" model available at www.gnupg.org | |
1335 and try out one of these. | |
7842 | 1336 |
10473 | 1337 17.5 Why are the passwords in accounts.xml not encrypted? |
1338 | |
7842 | 1339 This is a case of a really long answer to a short question. Read our |
10717
75427cc95dfd
[gaim-migrate @ 12312]
Luke Schierer <lschiere@pidgin.im>
parents:
10473
diff
changeset
|
1340 explanation at http://gaim.sf.net/plaintextpasswords.php. |
7842 | 1341 |
10473 | 1342 17.6 What is gaim-remote? |
1343 | |
7842 | 1344 gaim-remote is a second executable included with Gaim starting with 0.60. It |
1345 allows you to perform some actions to control/manipulate an existing Gaim | |
1346 process from the command line. Run gaim-remote --help to get an idea of what | |
1347 we currently envision it doing. | |
1348 | |
10473 | 1349 17.7 When will the next version of Gaim be released? |
1350 | |
9618 | 1351 The schedule for releases is every third Thursday. However, a new version |
7842 | 1352 will only be released if it meets a certain standard of quality (i.e., it |
1353 will not be released if it still has a large number of serious bugs). | |
1354 Therefore, some releases will take longer than others. Major rewrites means | |
1355 lots of new bugs to work out. The new version will be released as soon as it | |
1356 is possible to do so. | |
1357 | |
10473 | 1358 17.8 What will the next version be? |
1359 | |
1360 Starting with version 1.0.0, Gaim version numbers have 3 parts to them. The | |
1361 format is major.minor.micro. If we change something internally in Gaim such | |
1362 that some plugins won't work with the newer version, we will increment the | |
1363 major version number. If we don't increment the major version number, and | |
1364 we've added things to the Gaim API that won't break any older stuff, we will | |
1365 increment the minor version number. In any other cases, we will increment the | |
1366 micro version number. Even and odd numbers have nothing to do with stability, | |
1367 and you should always be running the latest release of Gaim to get new | |
1368 features and bug fixes. | |
1369 | |
1370 17.9 So, can I look forward to mega-sexy super functionality with Gaim? | |
1371 | |
1372 Yes, that is the intended idea. In fact, there have been quite a number of | |
1373 unpopular geeks who have made the switch to gaim. In a matter of days, the | |
1374 number of dates and awesomeness points received by the geek increased ten | |
1375 fold! You, too, can have an exciting life with Gaim. Get Gaim. Get the babes. | |
1376 Get uhh... hmm. | |
1377 |