nostui

A TUI client for Nostr

Current Features

• Timeline
• Post, Reply, React, Repost

Getting Started

Dowonload binaries from the release page.

Or, install manually via crates.io:

cargo install nostui

On NetBSD, a package is available from the official repositories. To install it, simply run:

pkgin install nostui

Setup

1. Create a config.json to the following path:

• Linux: ~/.config/nostui/config.json
• Windows: ~\AppData\Roaming\0m1\nostui\config.json
• macOS: ~/Library/Application Support/io.0m1.nostui/config.json

2. Add your key to the config.json:

{
    "key": "nsec1...", // or "npub..." for readonly mode
    "relays": ["wss://nos.lol"] // optional
}

Usage

Commands

nostui [OPTIONS]

Options:
  -t, --tick-rate <FLOAT>   Tick rate, i.e. number of ticks per second [default: 16]
  -f, --frame-rate <FLOAT>  Frame rate, i.e. number of frames per second [default: 16]
  -h, --help                Print help
  -V, --version             Print version

Default Keybindings

Keybinding	Description
k up	Scroll up
j down	Scroll down
q Ctrl-c Ctrl-d	Quit
home g	Scroll to top
end Shift-g	Scroll to bottom
esc	Unselect
n	New text note
Ctrl-p	Submit text note
r	Reply to the selected note
f	Send reaction
t	Repost