X-Git-Url: https://git.nmode.ca/signal-cli/blobdiff_plain/611d82425d04621a50122330fa8e0b4a04ac8028..67f6378f7f509f6cb55434bb516c154840c59bce:/man/signal-cli.1.adoc diff --git a/man/signal-cli.1.adoc b/man/signal-cli.1.adoc index 67e55bf5..4101986f 100644 --- a/man/signal-cli.1.adoc +++ b/man/signal-cli.1.adoc @@ -35,7 +35,7 @@ Options *--config* CONFIG:: Set the path, where to store the config. Make sure you have full read/write access to the given directory. - (Default: $HOME/.config/signal) + (Default: `$XDG_DATA_HOME/signal-cli` (`$HOME/.local/share/signal-cli`)) *-u* USERNAME, *--username* USERNAME:: Specify your phone number, that will be your identifier. @@ -140,6 +140,28 @@ RECIPIENT:: *-e*, *--endsession*:: Clear session state and send end session message. +sendReaction +~~~~~~~~~~~~ +Send reaction to a previously received or sent message. + +RECIPIENT:: + Specify the recipients’ phone number. + +*-g* GROUP, *--group* GROUP:: + Specify the recipient group ID in base64 encoding. + +*-e* EMOJI, *--emoji* EMOJI:: + Specify the emoji, should be a single unicode grapheme cluster. + +*-a* NUMBER, *--target-author* NUMBER:: + Specify the number of the author of the message to which to react. + +*-t* TIMESTAMP, *--target-timestamp* TIMESTAMP:: + Specify the timestamp of the message to which to react. + +*-r*, *--remove*:: + Remove a reaction. + receive ~~~~~~~ Query the server for new messages. New messages are printed on standardoutput and @@ -208,6 +230,62 @@ number:: Specify the safety number or fingerprint of the key, only use this option if you have verified the fingerprint. +updateProfile +~~~~~~~~~~~~~ +Update the name and/or avatar image visible by message recipients for the current users. +The profile is stored encrypted on the Signal servers. The decryption key is sent +with every outgoing messages (excluding group messages). + +*--name*:: + New name visible by message recipients. + +*--avatar*:: + Path to the new avatar visible by message recipients. + +*--remove-avatar*:: + Remove the avatar visible by message recipients. + +updateContact +~~~~~~~~~~~~~ +Update the info associated to a number on our contact list. This change is only +local but can be synchronized to other devices by using `sendContacts` (see +below). +If the contact doesn't exist yet, it will be added. + +NUMBER:: + Specify the contact phone number. + +*-n*, *--name*:: + Specify the new name for this contact. + +block +~~~~~ +Block the given contacts or groups (no messages will be received). This change is only +local but can be synchronized to other devices by using `sendContacts` (see +below). + +[CONTACT [CONTACT ...]]:: + Specify the phone numbers of contacts that should be blocked. + +*-g* [GROUP [GROUP ...]], *--group* [GROUP [GROUP ...]]:: + Specify the group IDs that should be blocked in base64 encoding. + +unblock +~~~~~~~ +Unblock the given contacts or groups (messages will be received again). This change is only +local but can be synchronized to other devices by using `sendContacts` (see +below). + +[CONTACT [CONTACT ...]]:: +Specify the phone numbers of contacts that should be unblocked. + +*-g* [GROUP [GROUP ...]], *--group* [GROUP [GROUP ...]]:: +Specify the group IDs that should be unblocked in base64 encoding. + +sendContacts +~~~~~~~~~~~~ +Send a synchronization message with the local contacts list to all linked devices. +This command should only be used if this is the master device. daemon ~~~~~~ @@ -259,9 +337,11 @@ Files The password and cryptographic keys are created when registering and stored in the current users home directory, the directory can be changed with *--config*: - $HOME/.config/signal/ +`$XDG_DATA_HOME/signal-cli/` (`$HOME/.local/share/signal-cli/`) -For legacy users, the old config directory is used as a fallback: +For legacy users, the old config directories are used as a fallback: + + $HOME/.config/signal/ $HOME/.config/textsecure/