A simple Nostr client with a gemini interface.

caracal is written in Rust and uses the rust-nostr SDK.

• Supports file uploads to nostr storage servers via the Titan protocol (implements NIP-96)
• Note drafts with Titan
• Encrypted private messages
• Remote signer (bunker)

Download

You can download the latest binary release for Linux here.

curl -L -o ~/.local/bin/caracal https://gitlab.com/cipres/caracal/-/releases/continuous-master/downloads/caracal
chmod +x ~/.local/bin/caracal

AppImage

There's also an AppImage that bundles both caracal and Lagrange (when you run it, you will automatically land on the homepage). You can download it here.

curl -L -o caracal-x86_64.AppImage https://gitlab.com/cipres/caracal/-/releases/continuous-master/downloads/caracal-x86_64.AppImage
chmod +x ./caracal-x86_64.AppImage
./caracal-x86_64.AppImage

Usage

To use caracal, you'll need to use a Gemini browser like Lagrange.

Start caracal, open Lagrange and go to gemini://localhost. You should see a page telling you that you need to use a X509 Gemini certificate.

From Lagrange, create an identity by selecting New identity for domain in the identities controller menu (top-right corner). Lagrange will then always use this certificate to access caracal.

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

Remote signer (Nostr Connect)

If you want to use a remote signer (bunker), create an identity in Lagrange (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.

Web content

To show embedded images in nostr notes, you just need to run a web-to-gemini proxy like levior and configure Lagrange to use the proxy.

Drafts

caracal supports writing and editing note drafts using the titan protocol. Click on New draft in the homepage and you should get a Titan dialog window from Lagrange. Be sure to select the correct identity.

Once you've uploaded your draft, you can edit it by just pressing Ctrl+e.

You can attach files to your note by clicking on Upload file in the note. Files are uploaded to a server that supports NIP-96 file uploads.

Just click on Post note when you're ready.

Donations

Monero: 46CAwqF4zwjL3Pe1oxtr2AGbmzLFY4rp6eAGkiDbAfYnYCAx8C47dex2XGb6VqXDUoYEZmemLzKxT1wkjFU6ebk23DensvR