4.6 KiB
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=
usage: gossip events_of_kind <kind>
events_of_pubkey_and_kind
print IDs of all events from of 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>