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