.. _librem_5_calls:

Phone Calls
===========

.. image:: images/calls/sm.puri.Calls.svg
   :width: 128
   :align: right
   :alt: The Calls application icon

The **Calls** application is used to place phone calls and handle incoming calls.

.. contents::
   :local:

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

Getting Started
---------------

When you start **Calls**, you will be shown the **Recent** page of the application. The first time you view this there will be no recent calls.

.. image:: images/calls/calls-no-recent-calls.png
   :align: center
   :scale: 50%
   :alt: No recent calls

Switch to the **Dial Pad** by selecting the icon at the bottom of the page. This will cause the dial pad to be shown.

.. |dialpad1| image:: images/calls/calls-dialpad-no-modem.png
   :scale: 50%
   :alt: The dial pad when no modem is available

.. |dialpad2| image:: images/calls/calls-dialpad.png
   :scale: 50%
   :alt: The dial pad allowing dialling to take place

.. centered:: |dialpad1| |dialpad2|

If the phone does not have access to the mobile network -- perhaps because the modem kill switch is enabled -- the screen will show the message, "Can't place calls: No SIM card" and it will not be possible to make calls. This is because the modem and SIM card are completely hidden from the phone when the kill switch is used.

If the modem is available, the blue call button will be enabled and you will be able to dial numbers and place calls.

Placing a Call
--------------

Ensure that the kill switch is disabled before attempting to place calls.

There are two ways to place a call from within the application:

 #. Open the *Dial Pad* page, dial the desired phone number, then press the blue dial button.
 #. Open the *Recent* page and press the handset (dial) button to the right of the contact you wish to call.

It is also possible to place a call :ref:`from the Contacts application <librem_5_contacts_viewing>`.

During a Call
~~~~~~~~~~~~~

When a call is placed, a page will appear showing the phone number, the elapsed time of the call and a collection of buttons that can be used to perform actions during the call -- some of these may be inactive.

.. image:: images/calls/calls-called.png
   :align: center
   :scale: 50%
   :alt: Information and available actions during a call

At the bottom of the page, a label indicates whether the call is encrypted, and the red button can be pressed to hang up the call.

Receiving a Call
----------------

The **Calls** application will be shown when a phone call is received. You will be prompted to accept or reject the incoming call.

.. image:: images/calls/calls-incoming-call.png
   :align: center
   :scale: 50%
   :alt: Handling an incoming call

Press the blue handset button to accept the call, or press the hang-up button to reject it.

Missed and rejected calls will appear in the :ref:`librem_5_quick_tour_notification_area` of the settings panel.
