Android client for nostr in Kotlin

NostrPostr – A nostr client and library for Android


This repository consists of multiple modules that will eventually be split into their own repositories but as long as the basic libraries and tools are in very active development, juggling multiple repositories isn’t worth it yet.

Image text

NIP support

Library, Relay and/or App implement the following NIPs. Not all NIPs apply to all parts and some NIPs might not be implemented fully.

  • NIP-01: Basic protocol flow description
  • NIP-02: Contact List and Petnames
  • NIP-03: OpenTimestamps Attestations for Events
  • NIP-04: Encrypted Direct Message
  • NIP-05: Mapping Nostr keys to DNS-based internet identifiers
  • NIP-06: Basic key derivation from mnemonic seed phrase
  • NIP-07: window.nostr capability for web browsers
  • NIP-09: Event Deletion
  • NIP-11: Relay Information Document
  • NIP-12: Generic Tag Queries
  • NIP-13: Proof of Work
  • NIP-14: Subject tag in text events.
  • NIP-15: End of Stored Events Notice
  • NIP-16: Event Treatment
  • NIP-20: Command Results
  • NIP-22: Event created_at Limits
  • NIP-25: Reactions
  • NIP-26: Delegated Event Signing
  • NIP-28: Public Chat
  • NIP-35: User Discovery
  • NIP-36: Sensitive Content
  • NIP-40: Expiration Timestamp

Nostr Library in Kotlin – nostrpostrlib

This is the core all other modules build upon. It provides facilities to connect to nostr relays, to send and receive events, to encrypt/decrypt messages, …


Here you can find some simple use cases of the library.

Android App

Here are the first efforts of developing a full Nostr Social client for Android.

It’s basically abandoned in favor of Nostroid and absent others putting work into it, it will be removed from this repo.


This is a full relay implementation.


As of the date of creation of this repository there was no Android nostr client. There was no nostr library for Android neither. The goal is to provide both with a focus on a clean and generally usable, fully featured library and a client with basic functionality.


If you want to contribute and aren’t a seasoned Android developer yet: Try it. It really is easy.

  1. Get Android Studio for free
  2. Clone this repository
  3. Import it in Android Studio
  4. Create an Android Virtual Device
  5. Launch the app (That “play” button top left)


  • What is nostr? “nostr” stands for “Notes and Other Stuff Transmitted by Relays” – a protocol that thanks to its simplicity might actually work to “create a censorship-resistant global social network once and for all”. Read more about it here.
  • Where can I find other tools for nostr? Check out awesome-nostr.
  • Where can I find nostr developers? On nostr of course but also on Telegram in nostr_protocol.


View Github

Leave a Reply

Your email address will not be published. Required fields are marked *