Nostr & Decentralized Social

KeytrPasskey Login for Nostr Keys

Passkey login for Nostr explained: how Keytr encrypts nsec keys, how to install it safely and how it compares with similar Nostr tools.

Free Open source Windows: Unverified v0.1.2 Updated 27 Oct 2026
10 min read Last update 27 Oct 2026 github.com/sovITxyz/keytr

Keytr is an open-source login tool for Nostr that lets people encrypt their nsec private key with a WebAuthn passkey and then unlock that key on another device. It is aimed at developers who want passkey sign-in in their Nostr apps and at users who are tired of copying raw private keys between devices. The project is free and licensed under AGPL-3.0.

Keytr is best understood as a building block rather than a finished desktop program. Its documentation mentions Windows among the supported platforms, but Windows support has not been confirmed, so treat any Windows-specific claim with care. The latest release is v0.1.2, and the last code update is dated October 27, 2026. The sections below explain the approach, how to install it safely, and how it compares with other tools in the Nostr ecosystem.

02

What Is an nsec Key and Why Does It Matter?

On Nostr, every identity is built from a pair of keys. The public key, usually shown as an npub, is shared openly so others can find and follow you. The private key, called the nsec, proves that you control the identity. Anyone who holds the nsec can sign posts and messages as that person.

This is what makes the nsec so sensitive. Unlike a typical website account, there is usually no central support desk that can reset it for you. If the key is exposed, the identity is exposed too. Many people copy their nsec into notes, password managers or clipboard history, and every extra copy adds another place where it can leak.

Keytr starts from a simple idea: the raw key should not sit in plain form on every device you use. Instead, the key is protected by a passkey and only becomes usable after the device confirms that you are present.

03

How Passkeys Change the Login Experience

A passkey is a credential that lives on a device or in a synced password manager and is unlocked with a fingerprint, face scan or screen passcode. WebAuthn is the browser standard that lets websites and apps request these credentials without handling a password directly.

Keytr uses a passkey to encrypt the nsec and then publishes the encrypted result to Nostr relays. On a second device, you authenticate with the passkey, and the key is decrypted locally. Consider a writer who signs in on a laptop during the day and then wants to post from a phone at night. Instead of exporting a raw private key to the phone, they confirm with the passkey that is already on it.

Whether a lost passkey can be recovered depends on how each client implements credential management. It is worth checking that detail before you depend on the setup for an identity you cannot afford to lose.

04

Who Should Consider Keytr?

Keytr fits best in two groups. The first is developers building Nostr clients or web apps who want users to sign in without pasting a raw nsec into a form. A small team making a community app might use the integration guide to add passkey sign-in in a single afternoon of work, then test it across a few devices.

The second group is experienced Nostr users who already understand key management and want a stronger way to protect their identity. They should choose clients that have adopted the flow and read the NIP-K1 specification to understand exactly what is being stored and where.

People who simply want a finished application with a familiar interface will usually be better served by a complete Nostr client. Keytr is designed to sit underneath such a client, not to replace it.

05

How Do Nostr Relays Handle Encrypted Keys?

Nostr relays are servers that receive, store and forward signed messages called events. They are run by different operators, and anyone can run one. When Keytr publishes an encrypted nsec to relays, the relay operators can store that ciphertext, so the security of the design depends heavily on the encryption itself and on the passkey that unlocks it.

The intent of the design is that ciphertext on its own should not reveal the private key to a relay operator or to someone who copies the data. Still, cryptographic designs deserve careful review, and the architecture documentation is the right place to examine the assumptions being made.

For users, the practical takeaway is simple. Treat the encrypted backup as sensitive data even though it is encrypted, and keep control of the passkey that protects it.

06

Key features

Architecture and System Design

A detailed walkthrough covers every layer of the system: the cryptography, the WebAuthn interaction, the Nostr integration, federated gateways and the overall security model. It shows where the key exists at each step and which component handles each job. Security reviewers and developers who want to audit the design before adopting it will find this the most valuable part of the documentation.

Integration Guide

This guide explains how to connect Keytr to a Nostr client's authentication flow. It covers session restore, which controls how a returning user gets back into the app, and credential management, which deals with how passkeys are stored and reused. Developers get a practical path from a standard login screen to passkey-based access.

Roadmap

The roadmap describes where the project stands today and where its authors intend to take it. Because Keytr is still at a 0.x version number, it helps to read this section before building anything that depends on a specific behavior. It is a short and useful read for anyone deciding whether the project's direction fits their needs.

NIP-K1 Specification

NIP-K1 is the canonical protocol specification behind Keytr. It defines PRF version 1 as the only specified encryption mode, while an older mode, KiH version 3, is kept for decryption only so that existing keys can be migrated. Anyone building a compatible client should treat this document as the reference for how the protocol behaves.
07

Supported coins

The documentation mentions Nostr as the network Keytr works with, and that is the only network it is built around. Keytr is a login and key-protection tool, not a miner, so the SHA-256 hashing algorithm sometimes associated with the project does not describe what it does. Its role is to protect Nostr identities, not to handle coins or mining operations.

08

How to install Keytr on Windows

  1. 1

    Get the code from the official source

    Start at the project's GitHub repository at https://github.com/sovITxyz/keytr or at the official website. Download only from the official website or the GitHub Releases page, and avoid mirrors or download links shared in chats and forums.

  2. 2

    Choose the latest release

    Open the Releases page and look for v0.1.2, the most recent version listed. Read the release notes before downloading so you know what changed and whether the update matters for your setup.

  3. 3

    Verify the file before running it

    Compute the SHA-256 checksum of the downloaded archive and compare it with the value published by the project. If the project also publishes a signature, verify that as well. Do not proceed if any value differs, and delete the file.

  4. Install or integrate

    Extract the release and follow the included instructions if a package is provided for your setup. Developers typically add Keytr to a JavaScript or TypeScript project, following the integration guide. Because it is library-style software, there is no single standard installer, so check the documentation for the path that matches your goal.

09

System requirements

  • A browser or platform with WebAuthn passkey support, which the login flow depends on.
  • Cross-client login through Related Origin Requests needs additional browser support.
  • Passkey PRF capability is reported as true, false or null; null means the capability is unknown until a credential is created to confirm it.
  • Passkey autofill through conditional mediation requires a suitable input element in the page's DOM instead of the standard modal picker.
10

How to use Keytr

Keytr runs inside a Nostr client that supports its login flow, so the steps below describe the typical sequence from the user's side.

  1. Open a Nostr client that offers passkey-based login with Keytr.
  2. Choose the option to create a new passkey-protected login and confirm with your device's biometric or passcode prompt.
  3. Let the client encrypt your nsec with the passkey. The encrypted result is then published to the relays the client uses.
  4. On a second device, open the same client and select the passkey sign-in option.
  5. Confirm the passkey prompt. The key is decrypted on that device so you can post and read normally.
  6. If the browser shows a picker instead of autofill, pick the saved passkey from the list.
  7. Check that your session restores correctly after closing and reopening the app.
  8. Keep a record of which devices hold a passkey, and remove access from devices you no longer use.

If sign-in fails, confirm that the browser supports the features listed in the system requirements, especially for cross-client login.

11

Pros & cons

Pros
  • Free and open source under AGPL-3.0, so the code can be read and reviewed.
  • Lets users avoid pasting a raw nsec into apps and forms.
  • Built on WebAuthn passkeys, a widely used browser standard.
  • Documentation covers architecture, integration and the NIP-K1 specification in depth.
  • Supports migration from an older decrypt-only mode, which helps existing users move forward.
Cons
  • Windows support has not been confirmed, even though the documentation mentions Windows.
  • It is a login layer for developers rather than a standalone application for everyday posting.
  • Cross-client login depends on browser support that may vary.
  • The version number of 0.1.2 signals an early release, so expect changes.
  • Recovery of a lost passkey depends on how each client implements it.
12

Is Keytr safe?

Keytr handles your nsec, which is the private key behind your Nostr identity, so treat it with the same care as a wallet key. Download the code only from the official GitHub repository or the project's official website. Before running anything, compute the SHA-256 checksum of the file and compare it with the published value, and verify the signature if one is provided. Never enter your nsec or any seed phrase on third-party websites, including sites that claim to offer a faster or simpler login. The project is licensed under AGPL-3.0, which means you can review the source before trusting it. Because security tools change, check the latest version on the official website before you install or update.

  • Official source only. Download from github.com/sovITxyz/keytr. Ignore ads and lookalike domains.
  • Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
  • Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
13

Alternatives

Keytr is not a Nostr client in the usual sense. It focuses on how a client protects and unlocks the nsec, while clients such as Amethyst, Gossip and Vega handle timelines, messages and posting. If you want a full app to use every day, one of those clients is the better starting point, and Keytr is something that a client might adopt. Command-line tools such as NAK and Nostr Commander RS serve people who work in a terminal and want scripted access, which is a different audience from passkey login. Nostr VPN addresses networking rather than identity, and Coop and Blockcore Notes are messaging and social apps. Compared with these, Keytr is narrower, but it is the only option in this group aimed squarely at protecting the key itself.

14

Specifications

Price
Free
Type
Open source
License
AGPL-3.0
Latest version
v0.1.2
Last update
27 Oct 2026
Windows support
Unverified (Windows mentioned in docs)
Source code
github.com/sovITxyz/keytr
15

Frequently asked questions

Keytr can be used safely if you get the code from the official GitHub repository or the official website and verify the SHA-256 checksum before running it. Its code is open under AGPL-3.0, so it can be reviewed. Never enter your nsec or seed phrase on third-party websites, and keep your passkey under your own control.

Yes, Keytr is free. It is open-source software licensed under AGPL-3.0, so you can use, study and modify the code under the terms of that license. There is no purchase price listed for the project.

The documentation mentions Windows among the supported platforms, but Windows support has not been confirmed. Keytr is aimed at developers who integrate it into Nostr clients, so its usefulness on Windows depends on the client you use. Test the login flow carefully before relying on it.

An nsec is the private key used on Nostr. It proves that you control your identity, and anyone who has it can sign posts and messages as you. Because it cannot be reset by a central provider, it should be protected carefully, which is the problem Keytr is designed to address.

You log in through a Nostr client that supports Keytr. The client asks you to create a passkey, encrypts your nsec with it and publishes the encrypted result to relays. On another device, you confirm the passkey, and the key is decrypted locally so you can sign in.

NIP-K1 is the protocol specification that defines how Keytr encrypts and distributes nsec keys using passkeys. It specifies PRF version 1 as the only encryption mode for new use, while the older KiH version 3 is kept only so that existing keys can be decrypted and migrated.

The documentation lists Android and iOS among the platforms, but platform support has not been confirmed in practice. Login behavior depends on the browser and client you use, so check whether your client supports passkey login on your phone before relying on it.

16

Verdict

Keytr is a thoughtful, open-source approach to a real problem on Nostr: protecting the private key without pasting it between devices. It suits developers building Nostr clients and experienced users who want to understand exactly how their identity is protected. It is not a finished daily-use application, and Windows support still needs to be confirmed in practice. If you want a complete Nostr client, start with one that already offers passkey login, and read the NIP-K1 specification before committing your identity to any setup.

Download now