Skip to content

PancakesArchitect/caracal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

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

screenshot-feed

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.

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.

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