gossip/docs/COMMANDS.md
2024-07-26 11:13:39 +12:00

242 lines
4.6 KiB
Markdown

# Gossip Commands
Gossip has a lot of command-line commands that can be run. To run a command line command,
pass it to gossip on the command line, for example:
```
$ gossip wgpu_renderer true
```
Most command line commands do something and then exit, rather than running the GUI program.
This file may not be up to date. You can see the list of all the commands with `gossip help`.
You can see the details of a particular command with `gossip help <command>`.
## Commands that launce the GUI program
### login
login on the command line before starting the gossip GUI.
**usage**: `gossip login`
### rapid
Use much faster disk access. A crash can corrupt your local data, unless your filesystem preserves write ordering.
**usage**: `gossip rapid`
Unlike all the other commands, you can pass one more command after rapid like this:
**usage**: `gossip rapid <command>`
### offline
Start gossip in offline mode.
**usage**: `gossip offline`
## Commands that operate in the terminal and then exit
### add_person_list
add a new person list with the given name.
**usage**: `gossip add_person_list <listname>`
### backdate_eose
backdate last_general_eose_at by 24 hours for every relay.
**usage**: `gossip backdate_eose`
### bech32_decode
decode the bech32 string.
**usage**: `gossip bech32_decode <bech32string>`
### bech32_encode_naddr
encode an event address (parameterized replaceable event link).
**usage**: `gossip bech32_encode_naddr <kind> <pubkeyhex> <d> [<relayurl>, ...]`
### clear_timeouts
clear relay avoidance timeouts.
**usage**: `gossip clear_timeouts`
### decrypt
decrypt the ciphertext from the pubkeyhex.
**usage**: `gossip decrypt <pubkeyhex> <ciphertext>`
### delete_spam_by_content
delete all feed-displayable events with content matching the substring (including giftwraps).
**usage**: `gossip delete_spam_by_content`
### delete_relay
delete a relay record from storage.
**usage**: `gossip delete_relay <relayurl>`
### dpi
override the DPI setting.
**usage**: `gossip dpi <dpi>`
### events_of_kind
print IDs of all events of kind=<kind>
**usage**: `gossip events_of_kind <kind>`
### events_of_pubkey_and_kind
print IDs of all events from <pubkeyhex> of kind=<kind>
**usage**: `gossip events_of_pubkey_and_kind <pubkeyhex> <kind>`
### export_encrypted_key
Export the encrypted private key
**usage**: `gossip export_encrypted_key`
### giftwraps
Decrypt all of your giftwraps
**usage**: `gossip giftwraps`
### help
Show this list.
**usage**: `gossip help`
### import_encrypted_private_key
import encrypted private key
**usage**: `gossip import_encrypted_private_key <ncryptsec>`
### import_event
import and process a JSON event
**usage**: `gossip import_event <event_json>`
### print_event
print the event (in JSON) from the database that has the given id
**usage**: `gossip print_event <idhex>`
### print_followed
print every pubkey that is followed
**usage**: `gossip print_followed`
### print_muted
print every pubkey that is muted
**usage**: `gossip print_muted`
### print_person_lists
print every pubkey in every person list
**usage**: `gossip print_person_lists`
### print_person
print the given person
**usage**: `gossip print_person <pubkeyHexOrBech32>`
### print_person_relays
print all the person-relay records for the given person
**usage**: `gossip print_person_relays <pubkeyhex>`
### print_relay
print the relay record
**usage**: `gossip print_relay <url>`
### print_relays
print all the relay records
**usage**: `gossip print_relays`
### print_seen_on
print the relays the event was seen on
**usage**: `gossip print_seen_on <idhex>`
### rebuild_indices
Rebuild all event-related indices
**usage**: `gossip rebuild_indices`
### rename_person_list
Rename a person list
**usage**: `gossip rename_person_list`
### reprocess_recent
Reprocess events that came during the last 24 hours
**usage**: `gossip reprocess_recent`
### reprocess_relay_lists
Reprocess relay lists (including kind 3 contents)
**usage**: `gossip reprocess_relay_lists`
### ungiftwrap
Unwrap the giftwrap event with the given ID and print the rumor (in JSON)
**usage**: `gossip ungiftwrap <idhex>`
### verify
Verify if the given event signature is valid
**usage**: `gossip verify <idhex>`
Note that gossip does not accept invalid events, so this old command probably has no practical use.
### verify_json
Verify if the passed in event JSON's signature is valid
**usage**: `gossip verify_json <event_json>`
### wgpu_renderer
Enable/Disable the WGPU rendering backend
**usage**: `gossip wgpu_renderer <true | false>`