X-Git-Url: https://git.nmode.ca/signal-cli/blobdiff_plain/337f84ed2162d3aaf7efa5e70c9ad9a092f98348..d156694213f9e1af35318268affc0001613ade85:/man/signal-cli.1.adoc diff --git a/man/signal-cli.1.adoc b/man/signal-cli.1.adoc index d8e0cb90..3cd260b3 100644 --- a/man/signal-cli.1.adoc +++ b/man/signal-cli.1.adoc @@ -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 @@ -204,10 +226,94 @@ number:: *-a*, *--trust-all-known-keys*:: Trust all known keys of this user, only use this for testing. -*-v* VERIFIED_FINGERPRINT, *--verified-fingerprint* VERIFIED_FINGERPRINT:: - Specify the safety number or fingerprint of the key, only use this option if you have verified - the fingerprint. +*-v* VERIFIED_SAFETY_NUMBER, *--verified-safety-number* VERIFIED_SAFETY_NUMBER:: + Specify the safety number of the key, only use this option if you have verified + the safety number. + +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. + +uploadStickerPack +~~~~~~~~~~~~~~~~~ +Upload a new sticker pack, consisting of a manifest file and the stickers in WebP +format (maximum size for a sticker file is 100KiB). +The required manifest.json has the following format: + +```json +{ + "title": "", + "author": "", + "cover": { // Optional cover, by default the first sticker is used as cover + "file": "", + "emoji": "" + }, + "stickers": [ + { + "file": "", + "emoji": "" + } + ... + ] +} +``` + +PATH:: + The path of the manifest.json or a zip file containing the sticker pack you + wish to upload. daemon ~~~~~~ @@ -249,7 +355,7 @@ Send a message to a group:: signal-cli -u USERNAME send -m "This is a message" -g GROUP_ID Trust new key, after having verified it:: - signal-cli -u USERNAME trust -v FINGER_PRINT NUMBER + signal-cli -u USERNAME trust -v SAFETY_NUMBER NUMBER Trust new key, without having verified it. Only use this if you don't care about security:: signal-cli -u USERNAME trust -a NUMBER