X-Git-Url: https://git.nmode.ca/signal-cli/blobdiff_plain/30e8e36635733b3e8c75a44e95785ba33cf55e61..9051f68ba64163690c6c0e7bc4214cb2a2f37002:/man/signal-cli.1.adoc?ds=sidebyside diff --git a/man/signal-cli.1.adoc b/man/signal-cli.1.adoc index bd855ab4..a626ab61 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" @@ -147,9 +151,22 @@ Can fix problems with receiving messages. *-n* NAME, *--device-name* NAME:: Set a new device name for the primary or linked device +*--username* NAME:: +Specify a username that can then be used to contact this account. +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. @@ -265,6 +282,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. @@ -336,6 +356,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. @@ -359,6 +395,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. @@ -411,6 +450,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. @@ -700,7 +742,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 @@ -718,18 +760,36 @@ Referred to generally as recipient. *-g* [GROUP], *--group-id* [GROUP]:: Alternatively, specify the group IDs for which to get the attachment. -=== daemon +=== getAvatar -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. +Gets the raw data for a specified contact, contact's profile or group avatar. +The attachment data is returned as a Base64 String. -*--dbus*:: -Export DBus interface on user bus. + -See **signal-cli-dbus**(5) for info on the dbus interface. +*--contact* [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. +*--profile* [RECIPIENT]:: +Specify the number of a recipient. + +*-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). + @@ -744,6 +804,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.