A simple command-line tool for using the Nostr network. It keeps your keys safe, lets you manage your profile, and supports multiple relays. It's made for fun, not serious use.
- Safe storage of private keys
- Post messages to multiple relays
- View and edit profile information (editing is still being worked on)
- List recent posts
- Customizable relay list
📖 Full documentation: https://hoot-docs.vercel.app
- Go 1.19 or later
- Git
-
Clone the repository:
git clone https://github.com/oth-body/hoot.git cd hoot -
Install dependencies:
go mod download
-
Build the binary:
go build -o hoot
-
(Optional) Move the binary to your PATH:
# Linux/macOS sudo mv hoot /usr/local/bin/ # Windows # Move hoot.exe to a directory in your PATH
Create a relays.txt file in:
- Your config directory:
- Linux:
~/.config/nostr-cli/ - macOS:
~/Library/Application Support/nostr-cli/ - Windows:
%APPDATA%\nostr-cli\
- Linux:
Example relays.txt:
wss://relay.damus.io
wss://relay.nostr.band
wss://nostr.wine
If no relays.txt is found, the above default relays will be used.
Hoot can be used in two modes: Interactive TUI (Terminal User Interface) or CLI (Command Line Interface).
Simply run hoot without any flags to launch the interactive terminal interface:
hootThe TUI provides:
- Login options: Enter nsec directly, use saved profile, or scan QR code (NIP-46)
- Multi-profile support: Save and switch between multiple Nostr accounts
- Post composer: Write and publish notes
- Feed viewer: Browse recent posts from the network
- Relay management: Add, remove, and configure relays
- Tipping: Send sats to other users via Lightning
- Use ↑/↓ arrow keys to navigate menus
- Press Enter to select an option
- Press Esc to go back
- Press q to quit
Use command-line flags for scripting or quick actions.
hoot -s -k <your-private-key>You'll be prompted to create an encryption password.
hoothoot -m "Hello Nostr! #introduction"Hashtags are automatically extracted and added as tags.
hoot -lhoot -phoot -u '{"name":"Alice","about":"Nostr enthusiast","lud16":"alice@getalby.com"}'hoot -r "wss://relay1.com,wss://relay2.com" -m "Hello from custom relays!"Hoot supports sending Lightning tips via NWC.
hoot -nwc "nostr+walletconnect://..."Get your NWC URI from a compatible wallet. See the awesome-nwc apps list for Alby, Mutiny, and others.
# Tip by npub
hoot -tip 100 -user npub1...
# Tip by hex pubkey
hoot -tip 100 -user <hex-pubkey>
# Tip directly to a Lightning address
hoot -tip 100 -user alice@getalby.comRegister your app as a handler for specific event kinds:
hoot -register-handler "1,6" -platform web -url-template "https://myapp.com/e/<bech32>"Recommend an app for handling a kind:
hoot -recommend "pubkey:d-identifier:1"Find handlers for a specific kind:
hoot -find-handlers 1| Flag | Description |
|---|---|
-m "message" |
Post a message to Nostr |
-k <key> |
Private key to store (use with -s) |
-s |
Store a new private key |
-r "relay1,relay2" |
Comma-separated list of relay URLs |
-l |
List your last 4 posts |
-p |
View your profile info |
-u '{"name":"..."} |
Update profile with JSON |
-dms |
View your direct messages |
-replies "event-id" |
View replies/reactions for a specific event |
-version |
Display version info |
-nwc "uri" |
Set NWC URI for tipping |
-tip <sats> |
Amount to tip (use with -user) |
-user <npub/hex/lud16> |
User to tip |
-register-handler "kinds" |
Register as handler for event kinds |
-platform <platform> |
Platform for handler (web, ios, android) |
-url-template "url" |
URL template for handler |
-recommend "pk:d:kind" |
Recommend an app for a kind |
-find-handlers <kind> |
Find handlers for a specific kind |
| Variable | Description |
|---|---|
HOOT_PASSWORD |
Encryption password (for automation/scripting) |