> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/encryptor/use-with-apps.md).

# Use Encryptor with an app

Use Encryptor with BlockMail & BlockChat: set up, unlock and register your public key.

{% hint style="info" %}
**Status: Production-ready, stable.** Encryptor is supported; no new features are planned. Last update: 18 Apr 2024 (version 0.1.0).
{% endhint %}

BlockMail & BlockChat show an Encryptor card that tells you what to do next. The card reads Encryptor's state every few seconds and changes as you complete each step.

## Steps

1. **Get Encryptor Now.** Encryptor is not detected. Select **Install Encryptor** to open the store listing. See [Install](https://wiki.4thtech.io/products/encryptor/install.md).

{% hint style="info" %}
**Screenshot to capture:** `encryptor--web--widget--not-installed--light--1280.png`. The BlockMail & BlockChat Encryptor card showing Get Encryptor Now.
{% endhint %}

2. **Ready to Set Up Encryptor.** Open the extension and [create or restore your key](https://wiki.4thtech.io/products/encryptor/create.md).
3. **Unlock Your Encryptor.** The extension is locked. [Unlock it](https://wiki.4thtech.io/products/encryptor/lock-unlock.md).

{% hint style="info" %}
**Screenshot to capture:** `encryptor--web--widget--locked--light--1280.png`. The Encryptor card showing Unlock Your Encryptor.
{% endhint %}

4. **Register Your Encryptor.** Your public key is not yet on the blockchain. Select **Register Encryptor**. Your wallet asks you to confirm a transaction on the network you use; confirm it.

{% hint style="info" %}
**Screenshot to capture:** `encryptor--web--widget--register-wallet-confirmation--light--1280.png`. The wallet confirmation to publish the public key, testnet only.
{% endhint %}

5. **Encryptor is Ready.** The card says your extension is fully configured.

{% hint style="info" %}
**Screenshot to capture:** `encryptor--web--widget--ready--light--1280.png`. The Encryptor card showing Encryptor is Ready.
{% endhint %}

## Sending an encrypted message

In the mail compose form, the **Use Encryption** switch ("For encrypted communication") is on by default. Encryption needs the **recipient** to be registered with Encryptor too. If they are not, the form says the recipient is not registered and that encrypted content cannot be sent to them. With the switch off, the app states that messages are sent in plain text.

{% hint style="info" %}
**Screenshot to capture:** `encryptor--web--mail-compose--encryption-on--light--1280.png`. The mail compose screen with the Use Encryption switch on.
{% endhint %}

Under the hood, see [How Encryptor works](https://wiki.4thtech.io/products/encryptor/how-it-works.md).
