Coracle screenshot

Coracle

Author Avatar Theme by Coracle social
Updated: 15 May 2025
322 Stars

An experimental Nostr client focused on unlocking the full potential of multiple relays. Browse, filter, zap, and create custom feeds to create a curated Nostr experience.

Categories

Overview:

Coracle is a web client for the Nostr protocol that aims to push the boundaries of what’s unique about Nostr. It focuses on features like relay selection and management, web-of-trust based moderation and content recommendations, and privacy protection. Coracle can be checked out at coracle.social. Dufflepud is a companion server that can be self-hosted and helps Coracle with tasks like link previews and image uploads.

Features:

  • Threads/social: Coracle supports threads and social interactions.
  • Profile search using NIP-50: Users can search for profiles using the NIP-50 protocol.
  • Login via extension, nsecbunker, and pubkey: Various login options are available for users.
  • Profile sharing via QR codes: Users can share their profiles using QR codes.
  • NIP 05 verification: Coracle supports NIP 05 verification.
  • NIP 65 relay selection and NIP 32 relay reviews: Users can select relays and provide reviews.
  • NIP 89 app recommendations: Coracle provides app recommendations based on NIP 89.
  • NIP 32 labeling and recommendations: Users can label and recommend content using NIP 32.
  • Bech32 entity search and scan: Users can search for and scan Bech32 entities.
  • Mention, reply, and reaction notifications: Users receive notifications for mentions, replies, and reactions.
  • Direct messages - NIP 04 and NIP 24: Coracle supports direct messaging using NIP 04 and NIP 24.
  • Note composition with mentions and topics: Users can compose notes with mentions and topics.
  • Content warnings, mute, and keyword mute: Coracle supports content warnings, muting, and keyword muting.
  • Profile pages, follow/unfollow, follow/follower count: Users have profile pages and can follow/unfollow others.
  • Thread muting, collapse thread: Users can mute threads and collapse threads.
  • Invoice, quote, mention, link, image, and video rendering: Coracle supports rendering various types of content.
  • Installable as a progressive web app: Coracle can be installed as a progressive web app.
  • Integrated media uploads via nostr.build: Users can upload media using nostr.build.
  • Lightning zaps and reactions: Coracle supports lightning zaps and reactions.
  • Feeds customizable by person, relay, and topic using NIP-51: Users can customize their feeds based on NIP-51.
  • AUTH (NIP-42) support for paid relays: Coracle supports paid relays with AUTH (NIP-42) support.
  • Multiplextr support for reducing bandwidth: Users can use Multiplextr to reduce bandwidth.
  • Profile and note metadata: Coracle provides profile and note metadata.
  • White-labeling support: Coracle supports white-labeling.
  • NIP 51 person lists: Users can create person lists using NIP 51.
  • Exportable copy of all user events: Users can export a copy of all their events.
  • NIP96 - HTTP File Storage Integration: Coracle integrates HTTP File Storage using NIP96.
  • Reporting and basic distributed moderation: Reporting and basic distributed moderation features are under development.
  • Content and person recommendations: Content and person recommendations are under development.
  • Private groups including administration, moderation, and membership: Private groups with administration, moderation, and membership features are under development.
  • Cross-posting between groups and public nostr: Cross-posting between groups and public Nostr is under development.
  • Public and private calendar events: Public and private calendar events are under development.
  • Public and private marketplaces: Public and private marketplaces are under development.

Installation:

To run Coracle locally:

  1. Clone the project repository: git clone https://github.com/coracle-social/coracle.git
  2. Navigate to the project directory: cd coracle
  3. Install dependencies: yarn
  4. Customize configuration in .env (optional)
  5. Start the development server: yarn dev

Summary:

Coracle is a web client for the Nostr protocol that focuses on pushing the boundaries of unique features like relay selection and management, web-of-trust based moderation and content recommendations, and privacy protection. It offers various features including social interactions, profile search, login options, profile sharing, NIP verifications, relay selection and reviews, content labeling and recommendations, media uploads, lightning zaps and reactions, and customizable feeds. Although some features like reporting and moderation, recommendations, private groups, cross-posting, and marketplace support are still under development, Coracle provides a comprehensive set of features for users interested in the Nostr protocol.