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

.. _librem_5_settings:

Changing the Settings
=====================

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

The **Settings** application is where you go to configure and customize your phone. You can also use it to manage your cellular connection and online accounts. This guide will cover some of the more common settings that you may need to adjust.

.. contents::
   :local:

Locate the icon shown above in the app drawer and press it to launch the application. Alternatively, open the panel at the top of the screen and press the settings (tools) button on the left.

Overview
--------

When you start **Settings**, you will be shown a list of categories. Press any of these to view and edit the settings for that category.

.. image:: images/settings/settings-main.png
   :align: center
   :scale: 50%
   :alt: The Settings start page, giving access to different categories

Some categories only appear when the peripheral associated with them is active.

.. _librem_5_settings_password:

Changing your Passcode
----------------------

When you first use your phone, you should change the default passcode to a new one that is unique to you.

.. note:: Currently, the passcode you use to unlock the phone is the same as the password you use to access the phone via other methods. This is expected to change in the future.

From the main **Settings** page, select **Details** to open a page showing information about the system software and the users who have accounts on the phone.

.. image:: images/settings/details-main.png
   :scale: 50%
   :align: center
   :alt: The Details page

From here, select the **Users** page to view and update information about your account on the phone. This is the page you visit when you want to update the passcode that unlocks the phone.

.. image:: images/settings/details-users.png
   :scale: 50%
   :align: center
   :alt: The Users page where the PIN/password can be changed

Select the button containing the hidden text, next to the **Password** label. This will open the **Change Password** dialog where you will need to enter both your old passcode and a new one.

.. image:: images/settings/details-users-change-password.png
   :scale: 50%
   :align: center
   :alt: The empty Change Password dialog

Enter your old passcode in the **Current Password** field. Then enter your new passcode in both the **New Password** and **Confirm** fields. This is designed to ensure that you have not mistyped your passcode.

.. image:: images/settings/details-users-change-password-entered.png
   :scale: 50%
   :align: center
   :alt: The Change Password dialog with completed fields

When you have entered all the information, press the **Change** button at the top-right of the screen to submit it and change the passcode. If you changed your mind, press the **Cancel** button at the top-left of the screen to keep using your old passcode.

.. image:: images/settings/details-users-change-password-same.png
   :scale: 50%
   :align: center
   :alt: A warning about duplicate passwords

You cannot use the same code for both old and new passcodes. If you submit the same code for both old and new passcode, the system will refuse it -- press **Close** if this occurs. If you want to keep using your old passcode, press the **Cancel** button to leave the **Change Password** dialog.

Mobile
------

The **Mobile** page is used to configure your phone's connection to the mobile network. See the :ref:`librem_5_mobile_networks_unlock_sim` section for more information.

Wi-Fi
-----

The **Wi-Fi** page is used to configure your phone's connection to local wireless networks. See the :ref:`librem_5_wlan` section for more information.

.. _librem_5_settings_notifications:

Notifications
-------------

The **Notifications** page is useful when you want to configure how notifications are reported for individual applications and components.

.. image:: images/settings/settings-notifications.png
   :scale: 50%
   :align: center
   :alt: The Notifications page, allowing customization for individual applications

Notifications can be turned off for all applications and services with the **Do Not Disturb** option.

Press any of the names in the list to open a page showing the preferences for that application or component.

.. image:: images/settings/settings-notifications-power.png
   :scale: 50%
   :align: center
   :alt: The Power notifications page

The options shown in the image are as follows:

 * **Notifications** -- this option allows you to enable or disable delivery of notifications completely for the application.
 * **Sound Alerts** will use the system alert sound configured in the **Sound** settings when enabled. Otherwise, no sounds will be used to alert you to new notifications from the application.
 * **Notification Popups** are shown at the top of the screen when a notification is delivered.
 * **Show Message Content in Popups** -- this option determines whether a summary or a more detailed notification is shown if the application supports it. Only a summary is shown if this is disabled.
 * **Lock Screen Notifications** can be shown when the phone is locked and the lock screen is displayed. When enabled, this may result in a message appearing on the lock screen.
 * **Show Message Content on Lock Screen** -- this option determines whether a summary or a more detailed message is shown in a lock screen notification if the application supports it.

When you have finished fine-tuning the notification settings, press the back button at the top-left of the screen to return to the main **Notifications** page.

See the :ref:`librem_5_notifications` chapter of this guide for background information about notifications and how they are used.

.. _librem_5_settings_region_language:

Region & Language
-----------------

The **Region & Language** page is where you can select the language used for applications and user interface elements. It is also where you can choose the default language for the :ref:`virtual keyboard <librem_5_virtual_keyboard>`.

.. image:: images/settings/settings-region-language.png
   :align: center
   :scale: 50%
   :alt: The Region & Language page

To choose a new default language for the virtual keyboard, press the |add| (add) button below the current language in the **Input Sources** section. This opens a dialog that allows you to add an input source -- this is where you select another language.

.. |add-input| image:: images/settings/settings-region-language-add-input.png
   :scale: 50%
   :alt: Add an Input Source

.. |add-input-other| image:: images/settings/settings-region-language-add-input-other.png
   :scale: 50%
   :alt: Choose the Other option

.. |add-input-list| image:: images/settings/settings-region-language-add-input-list.png
   :scale: 50%
   :alt: Select a language from the list

.. centered:: |add-input| |add-input-other| |add-input-list|

If you are not selecting English as the language, press the |view-more| (view more) button below the label, then select the **Other** label that appears. You can now choose from a language in the list -- swipe down to see more languages.

Alternatively, you can start typing with the keyboard to search for the language you want. As you enter the name of a language, the list will show matching languages. In the images below, we show Spanish as an example.

.. |add-input-spanish1| image:: images/settings/settings-region-language-add-input-spanish1.png
   :scale: 50%
   :alt: Searching for Spanish

.. |add-input-spanish2| image:: images/settings/settings-region-language-add-input-spanish2.png
   :scale: 50%
   :alt: Searching for Spanish

.. centered:: |add-input-spanish1| |add-input-spanish2|

When you have found your language, select it in the list, then press the **Add** button at the top-right of the screen. Alternatively, press **Cancel** to return to the **Region & Language** settings.

If you have selected and added a new language, it will be included in the list of **Input Sources**.

.. |english-spanish| image:: images/settings/settings-region-language-english-spanish.png
   :scale: 50%
   :alt: Both English and Spanish input sources

.. |only-spanish| image:: images/settings/settings-region-language-spanish.png
   :scale: 50%
   :alt: Spanish as the default input source

.. centered:: |english-spanish| |only-spanish|

To make the new language the default language for the keyboard, remove the other language by pressing the |delete| (delete) button next to its name. When this happens, the keyboard will change to show a layout that reflects the new default language. If it is not already shown, press the |keyboard| button at the bottom-right of the screen to open it.

.. note:: If the default language does not have a corresponding virtual keyboard layout then the US layout will be used. You can discuss and submit new layouts in the `Purism forums <https://forums.puri.sm/t/using-non-latin-language-on-librem-5/7103/31>`_.

.. _librem_5_settings_online_accounts:

Online Accounts
---------------

The **Online Accounts** page shows a variety of common online services that you may already have accounts with. Selecting one of these will take you through the process of storing your account details in the phone so that applications can access those services transparently.

.. _librem_5_change_password:
