.. include:: defs.txt
.. include:: images.txt

.. _librem_5_contacts:

Managing Contacts
=================

.. image:: images/contacts/org.gnome.Contacts.svg
   :width: 128
   :align: right
   :alt: The Contacts application icon

You can manage the phone numbers, e-mail addresses and other details of your contacts with the **Contacts** application.

.. contents::
   :local:

Locate the icon shown above in the app drawer and press it to launch the application.

Setup
-----

When you start **Contacts** for the first time, you will see the **Contacts Setup** page that lets you select the address book to use. Unless you have already :ref:`set up online accounts <librem_5_initial_setup>`, the only available address book will be the local address book.

.. |contacts-setup-image| image:: images/contacts/contacts-setup.png
   :scale: 50%
   :alt: A choice of a single address book
.. |contacts-setup-local-image| image:: images/contacts/contacts-setup-local.png
   :scale: 50%
   :alt: Choosing the local address book

.. centered:: |contacts-setup-image| |contacts-setup-local-image|

If you only want to use the local address book, select the **Local Address Book** label and press the **Done** button to proceed. You can :ref:`add online accounts <librem_5_contacts_accounts>` later.

If you want to configure :ref:`online accounts <librem_5_settings_online_accounts>` first, press **Quit** and start **Contacts** again later.

Adding a Contact
----------------

Initially, you will find that the list of contacts is empty. You can add contacts one-by-one, or you can import them from an existing file.

.. image:: images/contacts/contacts-no-contacts.png
   :align: center
   :alt: An empty contacts list

To add a contact, press the **+** (plus) icon in the top-left corner of the screen. The **New Contact** page will be shown. Here you can enter information about the contact.

.. |new-contact-image| image:: images/contacts/contacts-new-contact.png
   :scale: 50%
   :alt: An new empty contact
.. |add-contact-image| image:: images/contacts/contacts-adding-contact.png
   :scale: 50%
   :alt: Adding a new contact

.. centered:: |new-contact-image| |add-contact-image|

Other than the name and contact information, you can also choose a picture to make it easy to quickly identify them in conversations. Press the image button next to the name to do this.

When you have finished adding contact information, press the **Add** button in the top-right corner. The new contact should appear in the list. If you wish to discard the information instead, press **Cancel**.

.. image:: images/contacts/contacts-all-contacts.png
   :align: center
   :alt: The contacts list with a single contact

More contacts can be added in the same way. Alternatively, you can import an existing set of contacts by :ref:`connecting to your online accounts <librem_5_contacts_accounts>`.

.. _librem_5_contacts_viewing:

Viewing a Contact
-----------------

To view a contact, press its entry in the contacts list. A page will appear showing the name, picture and contact information.

.. image:: images/contacts/contacts-viewing-contact.png
   :align: center
   :alt: Viewing a contact

To return to the contacts list, press the back button in the top-left corner of the screen.

You can start a conversation with the contact by pressing the envelope icon next to their mobile phone number. This will launch **Chats**, the messaging application.

You can also start a phone call with the contact by pressing the handset button. This will launch **Calls**, the phone application.

Selecting Favorites
-------------------

In the contacts list, favorites are shown in a separate list above all other contacts.

.. image:: images/contacts/contacts-favorites.png
   :align: center
   :alt: Favorites appear

To add a contact to the list of favorites, enter the contact view by selecting a contact in the list. When viewing a contact you can press the |starred| (star) button in the top-right of the screen to add the contact to your list of favorites.

.. image:: images/contacts/contacts-viewing-contact.png
   :align: center
   :alt: Viewing a contact

The button will remain pressed. To remove the contact from the list of favorites, press it again to deselect it.

Press the back button to return to the contacts list.

Editing a Contact
-----------------

If you need to update or correct a contact's information, you can edit it by pressing the relevant item in the contacts list to view it.

Next, press the |view-more| (view more) icon in the top-right corner of the screen to open a menu, and select **Edit** to open the **Editing** page. This allows you to edit and add new information in the same way as the **New Contact** page.

.. |view-contact-menu-image| image:: images/contacts/contacts-example-menu.png
   :scale: 50%
   :alt: Viewing a contact

.. |edit-contact-image| image:: images/contacts/contacts-editing-contact.png
   :scale: 50%
   :alt: Editing a contact

.. centered:: |view-contact-menu-image| |edit-contact-image|

This page only shows the details that you created when adding or importing the contact. You can add new ones by pressing the |view-more| (view more) button below the contact details.

When you have finished editing the information, press the **Done** button in the top-right of the screen to save any changes, or press the **Cancel** button in the top-left of the screen.

Deleting a Contact
------------------

If you want to delete a contact, you first need to view it by pressing the relevant item in the contacts list.

Next, press the |view-more| (view more) icon in the top-right corner of the screen to open a menu, and select **Delete**.

.. |delete-contact-image| image:: images/contacts/contacts-deleting-contact.png
   :scale: 50%
   :alt: Deleting a contact

.. centered:: |view-contact-menu-image| |delete-contact-image|

The contact will be immediately deleted. However, you will have a short time to undo this action if you change your mind. Press the **Undo** button to recover the contact.

.. _librem_5_contacts_accounts:

Connecting to Online Accounts
-----------------------------

If you have a collection of contacts in an online service, you can access them from the application. Return to the contacts list, open the application menu and select **Online Accounts** to start the process of connecting to a service.

.. image:: images/contacts/contacts-menu.png
   :align: center
   :alt: Opening the application menu

This will open the **Online Accounts** page of the :ref:`Settings <librem_5_settings>` application where you can set up connections to existing accounts.
