A TUI client for Nostr

• Timeline
• Mention timeline
• Post, reply, react and repost
• Open per-user timelines as tabs
• Broadcast the currently playing track as a music status (NIP-38)

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

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
    "nip-38": { "enabled": true } // optional, broadcasts the currently playing track as a status (default: false)
}

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

You can override or add keybindings in your config file under keybindings.Home. Your settings are merged on top of the defaults, so you only need to list the keys you want to change.

{
    "keybindings": {
        "Home": {
            "<Ctrl-r>": "Repost",  // bind an additional key to an action
            "<t>": "ScrollToTop"   // override an existing default
        }
    }
}

Each key is written between < and >. Modifiers are joined with - (e.g. <Ctrl-p>, <Shift-g>, <Alt-Enter>). Special keys such as up, down, home, end, esc, enter, tab and space are also supported.

The following actions are available:

For how the codebase is organised — the layers, their dependency direction, and the contracts between them — see docs/architecture.md.