.. _librem_one_android_chat:

Librem Chat
===========

Install and start Librem Chat, enter your login credentials:

.. image:: img/LibremChat/LibremChat_01.png
   :scale: 40%
   :alt: Librem Chat 1

When logged-in, tap the **+** button:

.. image:: img/LibremChat/LibremChat_02.png
   :scale: 40%
   :alt: Librem Chat 2

to start a chat:

.. image:: img/LibremChat/LibremChat_03.png
   :scale: 40%
   :alt: Librem Chat 3

If you don't allow Librem Chat to access your address book, you won't see any contacts, so let's assume that and tap **Invite by ID**:

.. image:: img/LibremChat/LibremChat_04.png
   :scale: 40%
   :alt: Librem Chat 4

Type the handle/email/ID of your friend:

.. image:: img/LibremChat/LibremChat_05.png
   :scale: 40%
   :alt: Librem Chat 5

If discovered, it will be autocompleted:

.. image:: img/LibremChat/LibremChat_06.png
   :scale: 40%
   :alt: Librem Chat 6

Tap **INVITE** when ready:

.. image:: img/LibremChat/LibremChat_07.png
   :scale: 40%
   :alt: Librem Chat 7

...tap the checkmark to invite your friend to chat:

.. image:: img/LibremChat/LibremChat_08.png
   :scale: 40%
   :alt: Librem Chat 8

Here's how a chat windows looks like:

.. image:: img/LibremChat/LibremChat_09.png
   :scale: 40%
   :alt: Librem Chat 9

Write something, you will notice there is no indication of encrypted chat. So let's enable the encryption, tap the menu button:

.. image:: img/LibremChat/LibremChat_10.png
   :scale: 40%
   :alt: Librem Chat 10

...and tap on **Room Details**:

.. image:: img/LibremChat/LibremChat_11.png
   :scale: 40%
   :alt: Librem Chat 11

Go to *SETTINGS* tab and scroll down til you see the encryption option, and turn it on:

.. image:: img/LibremChat/LibremChat_12.png
   :scale: 40%
   :alt: Librem Chat 12

Tap the arrow (circled in green) to return back to chat once done.
When you write something and send it is likely that you will get something like shown below:

.. image:: img/LibremChat/LibremChat_13.png
   :scale: 40%
   :alt: Librem Chat 13

You must verify each of the device displayed by tapping the **VERIFY** and following the instructions shown:

.. image:: img/LibremChat/LibremChat_14.png
   :scale: 40%
   :alt: Librem Chat 14

(or if you are certain you are talking to the right person simply tap **VERIFY**). Tap **OK** when you are done:

.. image:: img/LibremChat/LibremChat_15.png
   :scale: 40%
   :alt: Librem Chat 15

...and have that message resent:

.. image:: img/LibremChat/LibremChat_16.png
   :scale: 40%
   :alt: Librem Chat 16

And that's all, we have an encrypted chat with our friend Thandi:

.. image:: img/LibremChat/LibremChat_17.png
   :scale: 40%
   :alt: Librem Chat 17

Tap the arrow to return to start screen. We see only one chat so far (blue circle), but we can repeat tapping the **+** icon again (green circle). But let's try joining some chatrooms first. Tap the *hashtag* icon:

.. image:: img/LibremChat/LibremChat_18.png
   :scale: 40%
   :alt: Librem Chat 18

...to list rooms. You can change *room directory* (blue circle) to select another domain. Let's join *Support* room on the `librem.one` domain, just tap the room:

.. image:: img/LibremChat/LibremChat_19.png
   :scale: 40%
   :alt: Librem Chat 19

You will see a preview of the room:

.. image:: img/LibremChat/LibremChat_20.png
   :scale: 40%
   :alt: Librem Chat 20

Tap the join button to join. Tap the arrow to return.
When in start screen, you can also use the menu button (*three vertical dots*) to do a search for public rooms or users. Tap the app menu button (*three vertical lines*):

.. image:: img/LibremChat/LibremChat_21.png
   :scale: 40%
   :alt: Librem Chat 21

...to see the Librem Chat menu:

.. image:: img/LibremChat/LibremChat_22.png
   :scale: 40%
   :alt: Librem Chat 22

...from where you can access *Settings*. Look at *Librem Chat manuals* to learn more about its settings and fine tunnning options.
If you wish to simply exit the app, use the **Exit** button. If you **Sign out** you will lose encryption keys for the existing encrypted chatrooms and you won't be able to read encrypted conversations when you log in again. Head over to *Librem Chat manuals* to learn about how to export your encryption keys.


.. seealso::
   Head on to Librem Chat manual to see how to edit your profile and fine-tune the app.