Skip to content

Latest commit

 

History

History
269 lines (137 loc) · 5.24 KB

COMMANDS.md

File metadata and controls

269 lines (137 loc) · 5.24 KB

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 launch 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

theme

Start gossip with the selected theme

usage: gossip theme <dark | light>

Commands that operate in the terminal and then exit

add_person_list

Createe 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. This will usually cause gossip to refetch recent things. 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. Be aware any event referencing it will cause it to be recreated.

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

Print IDs of all events of pubkey=

usage: gossip events_of_pubkey <pubkeyhex>

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

force_migration_level

Force the migration level. This is DANGEROUS and can easily corrupt your data.

usage: gossip force_migration_level <level>

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>

reaction_stats

Show statistics on reactions

usage: gossip reaction_stats

rebuild_fof

Rebuild friends-of-friends (will rebuild next time gossip starts)

usage: gossip rebuild_fof

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>