# {{ self::t!("manual") }}
## {{ self::t!("which_gemini_browser") }}

Although any Gemini browser can be used with caracal, you should use a browser that has a good identity system. I personally recommend to use the Lagrange Gemini browser, because it has an excellent and easy to use identity management system.

=> gemini://skyjake.fi/lagrange/ Lagrange

## Reloading pages

caracal will show you the latest available content that it has when you're accessing a page. When you want to get the latest, just press F5 in the browser to reload the page.

## {{ self::t!("identities") }}

In the Nostr world, your identity is tied to a keypair, comprised of your private key (used to sign messages) and your public key (which represents your public address).

Gemini uses TLS certificates.

=> gemini://geminiprotocol.net/

caracal maps your Gemini identity to your Nostr identity, and you can have multiple Nostr identities by creating different Gemini certificates and switching between them.

### Creating an identity

First go to the homepage by browsing gemini://localhost

=> gemini://localhost

From Lagrange, create an identity by opening the "Identity" menu, and then selecting "New identity for domain". You will be asked to type in the certificate's "Common Name", which should be a domain name. Put a domain name that you will remember and easily associate with the Nostr identity.

Lagrange will then always use this certificate to access caracal.

### Switching identities

You can easily change your current Nostr identity.

First go to the homepage of caracal. Then click on the profile icon next to the address bar. In the menu, click on the identity you want to use (in the menu an identity starts with an arrow). From that same menu you can also create a new identity.

## Remote signer (Nostr Connect)

If you want to use a remote signer (bunker), create an identity in Lagrange by selecting "New identity for domain", click on "More", and set the "Organization" field's value to "nostr". After creating the identity, activate it and you will be prompted for the Nostr Bunker URI. Copy-paste your bunker URI and send it.  You should now be connected to the remote signer.

## Uploading files

caracal uses the Titan protocol to transfer files. Titan is a sister-protocol to Gemini used to send content to Gemini servers.

caracal receives your files using Titan, and then uploads them to Blossom servers.

=> https://github.com/hzrd149/blossom

### How to upload files

When you are asked to upload a file, Lagrange will show a popup window titled "Upload with Titan".

Open a filemanager, and drag-and-drop the file you went to upload into this popup window (Lagrange will show the file path and size). Finally, click on the Upload button to send the file.
