2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY legal SYSTEM "legal.xml">
5 <!ENTITY appversion "2.26">
6 <!ENTITY manrevision "2.1">
7 <!ENTITY date "January 2009">
8 <!ENTITY app "<application>Empathy</application>">
9 <!ENTITY appname "Empathy">
10 <!ENTITY gtalk "http://www.google.com/talk/">
11 <!ENTITY icq "https://www.icq.com/register/">
12 <!ENTITY aim "http://dashboard.aim.com/aim">
13 <!ENTITY msn "https://accountservices.passport.net">
14 <!ENTITY yahoo "https://login.yahoo.com/config/login">
16 "http://account2.freeworlddialup.com/index.php?section_id=94">
17 <!ENTITY ekiga "https://www.ekiga.net/index.php?page=register">
19 "https://signup.sipphone.com/new-users/app?class=NewUser;proc=start">
20 <!ENTITY jabber "http://www.jabber.org/web/Jabber.org">
22 <?db.chunk.max_depth 2?>
23 <article id="index" lang="en">
24 <!-- please do not change the id; for translations, change lang to -->
25 <!-- appropriate code -->
27 <title>&app; Manual V&manrevision;</title>
30 <year>2008, 2009</year>
31 <holder>Ubuntu Documentation Project</holder>
33 <!-- An address can be added to the publisher information. If a role is
34 not specified, the publisher/author is the same for all versions of the
37 <publishername>Ubuntu Documentation Project</publishername>
40 <!-- licence stuff -->
44 <author role="maintainer">
45 <firstname>Milo</firstname>
46 <surname>Casagrande</surname>
48 <orgname>Ubuntu Documentation Project</orgname>
49 <address><email>milo@ubuntu.com</email></address>
53 <firstname>Seth</firstname>
54 <surname>Dudenhofer</surname>
56 <orgname>Ubuntu Documentation Project</orgname>
57 <address><email>sdudenhofer@gmail.com</email></address>
62 <releaseinfo revision="2.26" role="incomplete">
63 <ulink type="bug" url="http://bugzilla.gnome.org/show_bug.cgi?id=561033" />
64 <ulink type="planning" url="http://live.gnome.org/Empathy/Documentation" />
67 <!-- According to GNU FDL, revision history is mandatory if you are -->
68 <!-- modifying/reusing someone else's document. If not, you can omit it. -->
69 <!-- Remember to remove the &manrevision; entity from the revision -->
70 <!-- entries other than the current revision. -->
71 <!-- The revision numbering system for GNOME manuals is as follows: -->
72 <!-- * the revision number consists of two components -->
73 <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
74 <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
75 <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
76 <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
77 <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
78 <!-- to V3.0, and so on. -->
81 <revnumber>Empathy Manual V&manrevision;</revnumber>
84 <para role="author">Milo Casagrande
85 <email>milo@ubuntu.com</email>
87 <para role="publisher">Ubuntu Documentation Project</para>
92 <revnumber>Empathy Manual V2.0</revnumber>
93 <date>April 2008</date>
95 <para role="author">Milo Casagrande
96 <email>milo@ubuntu.com</email>
98 <para role="author">Seth Dudenhofer
99 <email>sdudenhofer@gmail.com</email>
101 <para role="publisher">Ubuntu Documentation Project</para>
107 This manual describes version &appversion; of &appname;.
110 <title>Feedback</title>
112 To report a bug or make a suggestion regarding the &app; application or
113 this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
114 type="help">GNOME Feedback Page</ulink>.
118 <abstract role="description">
120 &appname; is an application for instant messaging.
126 <indexterm zone="index">
127 <primary>Empathy</primary>
129 <indexterm zone="index">
130 <primary>empathy</primary>
131 <secondary>istant messaging</secondary>
134 <sect1 id="empathy-intro">
135 <title>Introduction</title>
137 &app; is a multi-protocol instant messaging program for the
138 GNOME Desktop. With &app; you can keep in touch with all of your
139 friends through lots of supported instant messaging services.
142 &app; supports the following services:
146 <acronym>AIM</acronym>
161 <acronym>IRC</acronym>
166 Jabber (or <acronym>XMPP</acronym>)
171 <acronym>MSN</acronym>
181 <acronym>SIP</acronym>
198 <sect1 id="empathy-getting-started">
199 <title>Getting Started</title>
201 <sect2 id="empathy-starting">
202 <title>Starting &appname;</title>
203 <para>You can start &app; in the following ways:
207 <term><guimenu>Applications</guimenu> menu</term>
211 <guisubmenu>Internet</guisubmenu>
212 <guimenuitem>Empathy Instant Messenger</guimenuitem>
218 <term>Command line</term>
220 <para>Type <command>empathy</command> and then press
221 <keycap>Enter</keycap>.
228 <sect2 id="emphaty-when-start">
229 <title>When You Start &appname;</title>
231 When you start &app; the following window is shown.
233 <figure id="empathy-FIG-mainwindow">
234 <title>&app; Main Window</title>
238 <imagedata fileref="figures/empathy-main-window.png" format="PNG"/>
242 Shows &app; main window. Contains the titlebar, the
243 menubar, contact list, status icon and status arrow
250 <!-- End of Figure -->
253 <xref linkend="empathy-TBL-1"/> describes the components of
255 <table frame="topbot" id="empathy-TBL-1">
256 <title>&app; Main Components</title>
257 <tgroup cols="2" colsep="0" rowsep="0">
258 <colspec colname="colspec0" colwidth="29.39*"/>
259 <colspec colname="colspec1" colwidth="70.61*"/>
263 <para>Component</para>
266 <para>Description</para>
277 Contains menus used to perform actions in &app;.
283 <para>Status Drop-Down List</para>
287 Allows to update the status.
293 <para>Account Button</para>
297 Opens the <guilabel>Accounts</guilabel> dialog.
303 <para>Contact List</para>
307 Shows all the available contacts and their
319 <sect1 id="empathy-accounts">
320 <title>Accounts</title>
322 To use &app; you need at least one account of the supported services.
325 If you don't already have an account and you don't have your <emphasis>user
326 name</emphasis> and <emphasis>password</emphasis>, you need to
327 register a new account (see <xref linkend="empathy-register-account" />).
330 In order to talk with other users, also called
331 <emphasis>contacts</emphasis>, you need to use the same service
332 they are using. If, for example, one contact is using the <emphasis
333 role="strong">Jabber</emphasis> service, you need to have an
334 account registered with that service.
337 &app; can handle as many accounts on any supported services as you want and
338 you can have them all open at the same time.
341 <sect2 id="empathy-register-account">
342 <title>Registering an Account</title>
344 You can freely register an account on any of the following
345 services. Follow the instructions reported on each website on
346 how to register your new account. At the end of the
347 registration process you should have a <emphasis>user
348 name</emphasis> (or an <emphasis>account ID</emphasis>) and
349 a <emphasis>password</emphasis> that you will use to
350 create the account in &app;.
353 Click on the name of the service to visit its website:
354 <!-- Need to do like that, if using only
355 <ulink>SERVICE</ulink> it wouldn't be possibile to
356 localize the links -->
359 <!-- Translators: try to find a localized version of the
360 registration service website -->
362 The <ulink type="http" url="&aim;">AIM</ulink> service.
366 <!-- Translators: try to find a localized version of the
367 registration service website -->
369 The <ulink type="http" url=">alk;">Google
370 Talk</ulink> service.
374 <!-- Translators: try to find a localized version of the
375 registration service website -->
377 The <ulink type="http" url="&icq;">ICQ</ulink> service.
381 <!-- Translators: try to find a localized version of the
382 registration service website -->
384 The <ulink type="http" url="&msn;">MSN</ulink> service.
388 <!-- Translators: try to find a localized version of the
389 registration service website -->
391 The <ulink type="http" url="&yahoo;">Yahoo</ulink> service.
397 For registering a <acronym>SIP</acronym> account, you can use one of the
403 <!-- Translators: try to find a localized version of the
404 registration service website -->
406 The <ulink type="http" url="&ekiga;">Ekiga</ulink> service.
410 <!-- Translators: try to find a localized version of the
411 registration service website -->
413 The <ulink type="http" url="&fwd;"><acronym>FWD</acronym></ulink> (Free
414 World Dialup) service.
418 <!-- Translators: try to find a localized version of the
419 registration service website -->
421 The <ulink type="http" url="&sipphone;">Sipphone</ulink> service.
427 For registering a <emphasis role="strong">Jabber</emphasis>
428 account, you can use the automatic
429 account creation of &app;. Not all Jabber service
430 providers support the automatic creation of accounts, one
431 service provider known to work with &app; is <ulink
432 type="http" url="&jabber;">jabber.org</ulink>.
435 If you already have a <emphasis
436 role="strong">Jabber</emphasis> account, you can use one of
437 the following services:
450 <sect2 id="empathy-create-account">
451 <title>Adding your Account to &app;</title>
453 To add your account to &app;, proceed as follows:
457 From the <link linkend="empathy-FIG-mainwindow">main window
458 </link> (<guilabel>Contact List</guilabel>)
459 click on the account button or press <keycap>F4</keycap> to open the
460 <guilabel>Accounts</guilabel> dialog.
465 If it is the first time you launch &app;:
469 From the <guilabel>Type</guilabel> drop-down list choose
470 the service you wish to add an account for, then click
471 on the <guibutton>Create</guibutton> button.
481 Click on the <guilabel>Add</guilabel> button.
486 From the <guilabel>Type</guilabel> drop-down list choose
487 the service you wish to add an account for, then click
488 on the <guibutton>Create</guibutton> button.
496 Fill the required fields with your <emphasis>user
498 <emphasis>password</emphasis>. Optionally, you can
499 modify some advanced options. For more information,
500 see <xref linkend="empathy-advanced-options"/>.
505 To enable the new account, select the
506 <guilabel>Enabled</guilabel> check-box next to
507 the name of the account in the box on the left.
513 <sect3 id="empathy-importing-accounts">
514 <title>Importing Accounts</title>
516 If you use another instant messaging program, you can import
517 the accounts from that program into &app;
522 At the moment &app; can import the accounts only from
523 the instant messaging program
524 <application>Pidgin</application>. For more information
525 about <application>Pidgin</application>, see the <ulink
526 type="http" url="http://www.pidgin.im/">Pidgin website</ulink>.
531 To import the accounts into &app;, proceed as follows:
535 From the <link linkend="empathy-FIG-mainwindow">main window
536 </link> (<guilabel>Contact List</guilabel>)
537 click on the account button or press <keycap>F4</keycap> to open the
538 <guilabel>Accounts</guilabel> dialog.
543 Click on the <guibutton>Import Accounts...</guibutton>
544 button to open the <guilabel>Import
545 Accounts</guilabel> dialog.
550 Select the accounts you would like to import by
551 clicking on the <guilabel>Import</guilabel> check-box.
556 When you have selected all the desired accounts, click
557 <guibutton>OK</guibutton> to import them. If you don't
558 want to import the accounts, click
559 <guibutton>Cancel</guibutton>.
564 When you import a new account into &app;, it will not be
568 To enable the new account, select the
569 <guilabel>Enabled</guilabel> check-box next to
570 the name of the account in the box on the left.
578 <sect2 id="empathy-edit-account">
579 <title>Editing an Account</title>
581 To edit one of your accounts, i.e. to change the
582 <emphasis>password</emphasis> or your <emphasis>user
583 name</emphasis>, proceed as follows:
587 From the <link linkend="empathy-FIG-mainwindow">main window
588 </link> (<guilabel>Contact List</guilabel>)
589 click on the account button or press <keycap>F4</keycap> to open the
590 <guilabel>Accounts</guilabel> dialog.
595 Select the account you wish to edit in the box on the
601 Modify the desired data.
609 Based on the type of the account, it is possibile to edit
615 To modify the identifier of an account, how &app; identifies
616 an account, proceed as follows:
620 From the <link linkend="empathy-FIG-mainwindow">main window
621 </link> (<guilabel>Contact List</guilabel>)
622 click on the account button or press <keycap>F4</keycap> to open the
623 <guilabel>Accounts</guilabel> dialog.
628 Select the account you wish to edit in the box on the
629 left and double-click on it's name.
634 Change the name of the account as you desire.
641 <sect2 id="empathy-disabling-removing-account">
642 <title>Disabling and Removing an Account</title>
644 To disable an account, proceed as follows:
650 From the <link linkend="empathy-FIG-mainwindow">main window
651 </link> (<guilabel>Contact List</guilabel>)
652 click on the account button or press <keycap>F4</keycap>
654 <guilabel>Accounts</guilabel> dialog.
659 Select the account you wish to disable in the box on the
660 left of the dialog and deselect the
661 <guilabel>Enabled</guilabel> check-box.
667 To remove an account, proceed as follows:
673 From the <link linkend="empathy-FIG-mainwindow">main window
674 </link> (<guilabel>Contact List</guilabel>)
675 click on the account button or press <keycap>F4</keycap>
677 <guilabel>Accounts</guilabel> dialog.
682 Select the account you wish to disable in the box on the
688 Click on the <guibutton>Remove</guibutton> button.
693 A dialog will be shown asking for confirmation. Click on
694 the <guibutton>Remove</guibutton> button to remove the account.
701 <sect2 id="empathy-edit-personal-information">
702 <title>Editing Personal Information</title>
704 To change your personal information, your alias and your
705 icon (the image that other contacts will see of you), for each
706 of your accounts, proceed as follows:
712 From the <link linkend="empathy-FIG-mainwindow">main
713 window</link>, select <menuchoice>
714 <guimenu>Edit</guimenu>
715 <guimenuitem>Personal Information</guimenuitem>
721 From the <guilabel>Account</guilabel> drop-down list, choose
722 the account you want to edit.
727 In the <guilabel>Alias</guilabel> text box, write your new
733 To change your icon, click on the person-looking button and
734 choose an image file.
739 When done, click <guibutton>Close</guibutton>.
747 An <emphasis>alias</emphasis> is an alternative way you
748 can identify yourself. You can use your real
749 name or your nickname.
755 <sect2 id="empathy-advanced-options">
756 <title>Advanced Options</title>
764 <sect1 id="empathy-contacts-groups">
765 <title>Contacts and Groups</title>
767 All the contacts are handled within &app;'s <link
768 linkend="empathy-FIG-mainwindow">main window</link>.
771 You can add or remove a contact or you can edit the information
772 of a particular contact. It is also possibile to arrange
773 contacts in groups. You can have a group for your work contacts,
774 one for you family contacts, and so on.
776 <sect2 id="empathy-add-contact">
777 <title>Adding and Removing a Contact</title>
779 To add a new contact, proceed as follows:
785 From the <link linkend="empathy-FIG-mainwindow">main
786 window</link> choose <menuchoice>
787 <guimenu>Chat</guimenu>
788 <guimenuitem>Add Contact...</guimenuitem>
789 </menuchoice>. The <guilabel>New Contact</guilabel>
790 dialog will be shown.
795 From the <guilabel>Account</guilabel> drop-down list,
796 choose the service used by the contact you are adding.
801 In the <guilabel>Identifier</guilabel> text box type the
802 <emphasis>address</emphasis> of the contact in the form
804 <userinput><replaceable>user name</replaceable>@<replaceable>service
805 domain</replaceable></userinput>.
810 In the <guilabel>Alias</guilabel> text box type the name
811 you want to give at the the new contact.
816 Click on <guibutton>Add</guibutton> to add the new contact.
822 To remove a contact, proceed as follows:
828 From the <link linkend="empathy-FIG-mainwindow">main
829 window</link>, select the contact you would like
830 to remove and right-click on it.
835 From the popup menu, choose <guilabel>Remove</guilabel> to
844 An <emphasis>alias</emphasis> is an alternative way you
845 can identify that particular contact. You can use the real
846 name or the nickname of that person.
851 <sect2 id="empathy-edit-contact">
852 <title>Editing a Contact</title>
854 To edit a contact, proceed as follows:
860 From the <link linkend="empathy-FIG-mainwindow">main
861 window</link>, select the contact you would like
862 to modify and choose <menuchoice>
863 <guimenu>Edit</guimenu>
864 <guisubmenu>Account</guisubmenu>
865 <guimenuitem>Modify</guimenuitem>
866 </menuchoice>, or right-click on it
867 and choose <guilabel>Modify</guilabel>.
873 From the <guilabel>Edit Contact Information</guilabel> dialog,
874 you can modify the <emphasis>alias</emphasis>
875 and the <emphasis>group</emphasis> of the contact.
880 An <emphasis>alias</emphasis> is an alternative way you
881 can identify that particular contact. You can use the real
882 name or the nickname of that person.
887 For more information about groups, see <xref
888 linkend="empathy-add-contact-group"/> and <xref
889 linkend="empathy-add-group"/>.
893 <sect2 id="empathy-add-contact-group">
894 <title>Adding a Contact to a Group</title>
896 To add a contact to one or more groups, proceed as follows:
902 From the <link linkend="empathy-FIG-mainwindow">main
903 window</link>, select the contact you would like
904 to modify and choose <menuchoice>
905 <guimenu>Edit</guimenu>
906 <guisubmenu>Account</guisubmenu>
907 <guimenuitem>Modify</guimenuitem>
908 </menuchoice>, or right-click on it
909 and choose <guilabel>Modify</guilabel>.
914 From the <guilabel>Groups</guilabel> section, select the
915 group, or groups, you want to add the contact to.
920 When done, click <guibutton>Close</guibutton>.
927 <sect2 id="empathy-add-group">
928 <title>Adding a New Group</title>
930 To add a new group, proceed as follows:
936 From the <link linkend="empathy-FIG-mainwindow">main
937 window</link>, select one contact and choose <menuchoice>
938 <guimenu>Edit</guimenu>
939 <guisubmenu>Account</guisubmenu>
940 <guimenuitem>Modify</guimenuitem>
941 </menuchoice>, or right-click on it
942 and choose <guilabel>Modify</guilabel>.
947 In the <guilabel>Groups</guilabel> section, write the
948 name of the group you want to add and then click on
949 <guibutton>Add Group</guibutton>.
954 When done, click <guibutton>Close</guibutton>.
965 <sect1 id="empathy-send-receive-message">
966 <title>Sending and Receiving Messages</title>
971 <sect1 id="empathy-preferences">
972 <title>Preferences</title>