X-Git-Url: https://git.nmode.ca/signal-cli/blobdiff_plain/7b0744ec758b1ccbe3c9ce5a1e6dea5d7e2313da..0cc2da690aafa0b821c09dcf9e7166361f15b01a:/man/signal-cli.1.adoc diff --git a/man/signal-cli.1.adoc b/man/signal-cli.1.adoc index 4814d28a..80d4c37e 100644 --- a/man/signal-cli.1.adoc +++ b/man/signal-cli.1.adoc @@ -25,7 +25,7 @@ For this use-case, it has a dbus and a JSON-RPC interface, that can be used to s For some functionality the Signal protocol requires that all messages have been received from the server. The `receive` command should be regularly executed. -In daemon mode messages are continuously received. +In daemon mode messages are by default continuously received. == Options @@ -44,6 +44,7 @@ If `--verbose` is also given, the detailed logs will only be written to the log *--scrub-log*:: Scrub possibly sensitive information from the log, like phone numbers and UUIDs. +Doesn't work reliably on dbus logs with very verbose logging (`-vvv`) *--config* CONFIG:: Set the path, where to store the config. @@ -70,6 +71,9 @@ Make request via user dbus. *--dbus-system*:: Make request via system dbus. +*--bus-name*:: +Connect to another D-Bus bus name than the default. + *-o* OUTPUT-MODE, *--output* OUTPUT-MODE:: Specify if you want commands to output in either "plain-text" mode or in "json". Defaults to "plain-text" @@ -98,12 +102,15 @@ If the account was deleted (with --delete-account) it cannot be reactivated. The verification should be done over voice, not SMS. Voice verification only works if an SMS verification has been attempted before. -*--captcha*:: +*--captcha* CAPTCHA:: The captcha token, required if registration failed with a captcha required error. To get the token, go to https://signalcaptchas.org/registration/generate.html For the staging environment, use: https://signalcaptchas.org/staging/registration/generate.html After solving the captcha, right-click on the "Open Signal" link and copy the link. +*--reregister*:: +Register even if account is already registered. + === verify Verify the number using the code received via SMS or voice. @@ -147,6 +154,23 @@ Can fix problems with receiving messages. *-n* NAME, *--device-name* NAME:: Set a new device name for the primary or linked device +*-u* NAME *--username* NAME:: +Specify a username that can then be used to contact this account. +This can either be just the nickname (e.g. test) or the complete username with discriminator (e.g. test.000). +Returns the new username with discriminator and the username link. + +*--delete-username*:: +Delete the username associated with this account. + +*--unrestricted-unidentified-sender* {true,false}:: +Enable if anyone should be able to send you unidentified sender messages. + +*--discoverable-by-number* {true,false}:: +Enable/disable if the account should be discoverable by phone number + +*--number-sharing* {true,false}:: +Indicates if Signal should share its phone number when sending a message. + === startChangeNumber Change an account to a new phone number with SMS or voice verification. @@ -262,6 +286,9 @@ Send the message to self without notification. *-g* GROUP, *--group-id* GROUP:: Specify the recipient group ID in base64 encoding. +*-u* USERNAME, *--username* USERNAME:: +Specify the recipient username or username link. + *-m* MESSAGE, *--message* MESSAGE:: Specify the message. @@ -333,6 +360,22 @@ Clear session state and send end session message. *--edit-timestamp*:: Specify the timestamp of a previous message with the recipient or group to send an edited message. +=== sendMessageRequestResponse + +Send response to a message request to linked devices. + +RECIPIENT:: +Specify the recipients’ phone number. + +*-g* GROUP, *--group-id* GROUP:: +Specify the recipient group ID in base64 encoding. + +*-u* USERNAME, *--username* USERNAME:: +Specify the recipient username or username link. + +*--type* TYPE:: +Type of message request response (accept, delete) + === sendPaymentNotification Send a payment notification. @@ -356,6 +399,9 @@ Specify the recipients’ phone number. *-g* GROUP, *--group-id* GROUP:: Specify the recipient group ID in base64 encoding. +*-u* USERNAME, *--username* USERNAME:: +Specify the recipient username or username link. + *-e* EMOJI, *--emoji* EMOJI:: Specify the emoji, should be a single unicode grapheme cluster. @@ -408,6 +454,9 @@ Specify the recipients’ phone number. *-g* GROUP, *--group-id* GROUP:: Specify the recipient group ID in base64 encoding. +*-u* USERNAME, *--username* USERNAME:: +Specify the recipient username or username link. + *-t* TIMESTAMP, *--target-timestamp* TIMESTAMP:: Specify the timestamp of the message to delete. @@ -697,7 +746,7 @@ Install a sticker pack for this account. *--uri* [URI]:: Specify the uri of the sticker pack. -e.g. https://signal.art/addstickers/#pack_id=XXX&pack_key=XXX)" +e.g. https://signal.art/addstickers/#pack_id=XXX&pack_key=XXX === getAttachment @@ -715,18 +764,36 @@ Referred to generally as recipient. *-g* [GROUP], *--group-id* [GROUP]:: Alternatively, specify the group IDs for which to get the attachment. -=== daemon +=== getAvatar + +Gets the raw data for a specified contact, contact's profile or group avatar. +The attachment data is returned as a Base64 String. -signal-cli can run in daemon mode and provides an experimental dbus or JSON-RPC interface. -If no `-a` account is given, all local accounts will be exported as separate dbus objects under the same bus name. +*--contact* [RECIPIENT]:: +Specify the number of a recipient. -*--dbus*:: -Export DBus interface on user bus. + -See **signal-cli-dbus**(5) for info on the dbus interface. +*--profile* [RECIPIENT]:: +Specify the number of a recipient. -*--dbus-system*:: -Export DBus interface on system bus. + -See **signal-cli-dbus**(5) for info on the dbus interface. +*-g* [GROUP], *--group-id* [GROUP]:: +Alternatively, specify the group ID for which to get the avatar. + +=== getSticker + +Gets the raw data for a specified sticker. +The attachment data is returned as a Base64 String. + +*--pack-id* [PACK_ID]:: +Specify the id of a sticker pack (hex encoded). + +*--sticker-id* [STICKER_ID]:: +Specify the index of a sticker in the sticker pack. + +=== daemon + +signal-cli can run in daemon mode and provides JSON-RPC or an experimental dbus interface. +If no `-a` account is given, all local accounts will be loaded. +Multiple interfaces can be used at the same time, e.g. `daemon --socket --dbus` *--socket [SOCKET]*:: Export a JSON-RPC interface on a UNIX socket (default $XDG_RUNTIME_DIR/signal-cli/socket). + @@ -741,6 +808,17 @@ Expose a JSON-RPC interface as http endpoint (default localhost:8080). The JSON-RPC endpoint is `/api/v1/rpc`. + See **signal-cli-jsonrpc**(5) for info on the JSON-RPC interface. +*--dbus*:: +Export DBus interface on user bus. + +See **signal-cli-dbus**(5) for info on the dbus interface. + +*--dbus-system*:: +Export DBus interface on system bus. + +See **signal-cli-dbus**(5) for info on the dbus interface. + +*--bus-name*:: +Claim another D-Bus bus name than the default. + *--ignore-attachments*:: Don’t download attachments of received messages.