> ## Documentation Index
> Fetch the complete documentation index at: https://gerfaut-wallet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a wallet

> Start watching a wallet in Gerfaut from its descriptor, extended public key or address: paste it, open a file or scan a QR code, then check the first address.

Give Gerfaut the public side of your wallet: the descriptor, extended public key or address your signing device or wallet software exports. Gerfaut refuses anything that contains a private key or a seed phrase.

## Add the wallet

**1. Open the add dialog**

**Android**

Select **Add a wallet** at the bottom of the home screen.

**Desktop**

Select the wallet switcher at the top of the sidebar, then **Add a wallet**. Before your first wallet, the sidebar shows **Add a wallet** in its place.

**2. Paste, import or scan the wallet**

Paste it in `Descriptor, extended public key, or address`, then select **Continue**. Two other ways in:

* **Import a file:** A `.txt`, `.json`, `.desc` or `.bsms` file, such as the export of another wallet.
* **Scan a QR code:** Plain text, UR or BBQr, animated or not. Keep the camera on an animated code until the counter reaches its total. On Android the button reads **Scan**.

A refused input says why, under the field.

**3. Check the first address**

The card reads `Recognized as` with the kind of input, then `First address`, the first address Gerfaut derives.

> [!WARNING]
>
> Compare `First address` with the first address your signing device or wallet software shows. A different address means Gerfaut watches another wallet.

For an extended public key, check the script type too: see [Wallet types](/docs/wallets/wallet-types#pick-the-script-type-of-an-extended-public-key).

When a QR code names no receive or change path, Gerfaut shows `This QR code carries no receive or change path, so Gerfaut assumes the usual 0/* and 1/*. Compare the first address with your signer.` If `First address` differs, select **Back**. Then paste or import the descriptor your signing device or wallet software exports, which names its paths.

**Android**

![The Add a wallet screen on Android after pasting a descriptor: the Recognized as card with the first address, the Name field, the network buttons and the Add wallet button.](https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/images/android/add-wallet.webp?fit=max\&auto=format\&n=lxGkHstk_-7EsZEA\&q=85\&s=18143050ddf4953e3f1dd234546d3283)

**Desktop**

![The Add a wallet dialog on desktop after pasting an extended public key: the Recognized as card with the first address, the SLIP-132 notice, the Advanced button, the Name and Network fields and the Add wallet button.](https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/images/desktop/add-wallet.webp?fit=max\&auto=format\&n=lxGkHstk_-7EsZEA\&q=85\&s=2167fca4a8e0e4c8f4831e9e827c5386)

**4. Name the wallet and select Add wallet**

Enter a name in `Name`. When the input [fits several networks](/docs/wallets/wallet-types#pick-a-network), pick one in `Network` and check `First address` again. Gerfaut opens the wallet and runs its first sync.

**Android**

<video autoPlay muted loop playsInline preload="metadata" src="https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/videos/wallets/add-a-wallet-android.mp4?fit=max&auto=format&n=lxGkHstk_-7EsZEA&q=85&s=4c58b243a02874683ce8a3148528ef33" aria-label="Adding a wallet on Android: Continue, the Recognized as card with the first address, the name Savings typed, Add wallet, then the synced wallet page." />

**Desktop**

<video autoPlay muted loop playsInline preload="metadata" src="https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/videos/wallets/add-a-wallet-desktop.mp4?fit=max&auto=format&n=lxGkHstk_-7EsZEA&q=85&s=3b59e89729d32e75693f2b4d3354bc97" aria-label="Adding a wallet on desktop: Continue, the Recognized as card with the first address, the name Savings typed, Add wallet, then the synced Overview." />

> **Use a custom derivation path**
>
> For an extended public key used outside the usual derivation branches, open **Advanced** on the confirmation step. Enter the `Receive path`, the `Change path` and the `Key origin`, then select **Apply**. Check the new first address again.

## Manage your wallets

Open **Settings** > **Wallets**. Each wallet has its own row:

* **Rename:** Select **Rename**, enter the new name and select **Save name**. Selecting the wallet name at the top of its page on Android, or of its Overview on desktop, does the same.
* **Icon:** Select **Icon**, then one of seven icons, such as `Key`, `Snowflake` or `Pin`.
* **Rescan:** Read the wallet again from its first address, change included, up to the `Gap limit` at the top of the section. Raise that limit first for coins further out. Gerfaut then shows the result, such as `Rescanned · 2 new transactions`.
* **Remove:** Stop watching the wallet once you confirm with **Remove wallet**. Nothing moves on-chain.
* **Reorder:** Drag a wallet by its handle, or hold a wallet card on the Android home screen and drag it.
* **Advanced:** Select **Advanced** under the list to pick the wallets [Live follows first](/docs/settings/notifications#pin-the-wallets-live-follows-first) when it cannot follow every address.

**Android**

![The Wallets screen on Android: the gap limit field and two wallet rows, each with Rename, Icon, Rescan and Remove actions and a drag handle, then Advanced.](https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/images/android/settings-wallets.webp?fit=max\&auto=format\&n=lxGkHstk_-7EsZEA\&q=85\&s=9583463e6b3c34d432298b63f226da86)

**Desktop**

![The Wallets section of the desktop settings: the gap limit field and two wallet rows, each with Icon, Rescan, Rename and Remove actions and a drag handle.](https://mintcdn.com/gerfaut/lxGkHstk_-7EsZEA/images/desktop/settings-wallets.webp?fit=max\&auto=format\&n=lxGkHstk_-7EsZEA\&q=85\&s=76a460e2a722163f617dc1c7b2389823)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.