.. _l1_android_chat:

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

Install and start Librem Chat, enter your login credentials:

.. image:: /_files/l1/android/chat/LibremChat_01.png
   :scale: 40%
   :alt: Librem Chat 1
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_02.png
   :scale: 40%
   :alt: Librem Chat 2
   :class: no-scaled-link

to start a chat:

.. image:: /_files/l1/android/chat/LibremChat_03.png
   :scale: 40%
   :alt: Librem Chat 3
   :class: no-scaled-link

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:: /_files/l1/android/chat/LibremChat_04.png
   :scale: 40%
   :alt: Librem Chat 4
   :class: no-scaled-link

Type the handle/email/ID of your friend:

.. image:: /_files/l1/android/chat/LibremChat_05.png
   :scale: 40%
   :alt: Librem Chat 5
   :class: no-scaled-link

If discovered, it will be autocompleted:

.. image:: /_files/l1/android/chat/LibremChat_06.png
   :scale: 40%
   :alt: Librem Chat 6
   :class: no-scaled-link

Tap **INVITE** when ready:

.. image:: /_files/l1/android/chat/LibremChat_07.png
   :scale: 40%
   :alt: Librem Chat 7
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_08.png
   :scale: 40%
   :alt: Librem Chat 8
   :class: no-scaled-link

Here's how a chat windows looks like:

.. image:: /_files/l1/android/chat/LibremChat_09.png
   :scale: 40%
   :alt: Librem Chat 9
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_10.png
   :scale: 40%
   :alt: Librem Chat 10
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_11.png
   :scale: 40%
   :alt: Librem Chat 11
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_12.png
   :scale: 40%
   :alt: Librem Chat 12
   :class: no-scaled-link

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:: /_files/l1/android/chat/LibremChat_13.png
   :scale: 40%
   :alt: Librem Chat 13
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_14.png
   :scale: 40%
   :alt: Librem Chat 14
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_15.png
   :scale: 40%
   :alt: Librem Chat 15
   :class: no-scaled-link

...and have that message resent:

.. image:: /_files/l1/android/chat/LibremChat_16.png
   :scale: 40%
   :alt: Librem Chat 16
   :class: no-scaled-link

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

.. image:: /_files/l1/android/chat/LibremChat_17.png
   :scale: 40%
   :alt: Librem Chat 17
   :class: no-scaled-link

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 to list rooms:

.. image:: /_files/l1/android/chat/LibremChat_18.png
   :scale: 40%
   :alt: Librem Chat 18
   :class: no-scaled-link

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:: /_files/l1/android/chat/LibremChat_19.png
   :scale: 40%
   :alt: Librem Chat 19
   :class: no-scaled-link

You will see a preview of the room:

.. image:: /_files/l1/android/chat/LibremChat_20.png
   :scale: 40%
   :alt: Librem Chat 20
   :class: no-scaled-link

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:: /_files/l1/android/chat/LibremChat_21.png
   :scale: 40%
   :alt: Librem Chat 21
   :class: no-scaled-link

...to see the Librem Chat menu:

.. image:: /_files/l1/android/chat/LibremChat_22.png
   :scale: 40%
   :alt: Librem Chat 22
   :class: no-scaled-link

...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.