nmode's Git Repositories - signal-cli/blob - man/signal-cli.1.adoc

   1 /////
   2 vim:set ts=4 sw=4 tw=82 noet:
   3 /////
   4 :quotes.~:
   5
   6 = signal-cli (1)
   7
   8 Name
   9 ----
  10 signal-cli - A commandline and dbus interface for the Signal messenger
  11
  12 Synopsis
  13 --------
  14 *signal-cli* [--config CONFIG] [-h | -v | -u USERNAME | --dbus | --dbus-system] command [command-options]
  15
  16 Description
  17 -----------
  18
  19 signal-cli is a commandline interface for libsignal-service-java. It supports
  20 registering, verifying, sending and receiving messages. For registering you need a
  21 phone number where you can receive SMS or incoming calls.
  22 signal-cli was primarily developed to be used on servers to notify admins of
  23 important events. For this use-case, it has a dbus interface, that can be used to
  24 send messages from any programming language that has dbus bindings.
  25
  26 Options
  27 -------
  28
  29 *-h*, *--help*::
  30         Show help message and quit.
  31
  32 *-v*, *--version*::
  33         Print the version and quit.
  34
  35 *--config* CONFIG::
  36         Set the path, where to store the config.
  37         Make sure you have full read/write access to the given directory.
  38         (Default: `$XDG_DATA_HOME/signal-cli` (`$HOME/.local/share/signal-cli`))
  39
  40 *-u* USERNAME, *--username* USERNAME::
  41         Specify your phone number, that will be your identifier.
  42         The phone number must include the country calling code, i.e. the number must
  43         start with a "+" sign.
  44
  45 *--dbus*::
  46         Make request via user dbus.
  47
  48 *--dbus-system*::
  49         Make request via system dbus.
  50
  51 Commands
  52 --------
  53
  54 register
  55 ~~~~~~~~
  56 Register a phone number with SMS or voice verification. Use the verify command to
  57 complete the verification.
  58
  59 *-v*, *--voice*::
  60         The verification should be done over voice, not SMS.
  61
  62 verify
  63 ~~~~~~
  64 Verify the number using the code received via SMS or voice.
  65
  66 VERIFICATIONCODE::
  67         The verification code.
  68
  69 *-p* PIN, *--pin* PIN::
  70         The registration lock PIN, that was set by the user. Only required if a PIN was set.
  71
  72 unregister
  73 ~~~~~~~~~~
  74 Disable push support for this device, i.e. this device won't receive any more messages.
  75 If this is the master device, other users can't send messages to this number anymore.
  76 Use "updateAccount" to undo this.
  77 To remove a linked device, use "removeDevice" from the master device.
  78
  79 updateAccount
  80 ~~~~~~~~~~~~~
  81 Update the account attributes on the signal server.
  82 Can fix problems with receiving messages.
  83
  84 setPin
  85 ~~~~~~
  86 Set a registration lock pin, to prevent others from registering this number.
  87
  88 REGISTRATION_LOCK_PIN::
  89     The registration lock PIN, that will be required for new registrations (resets after 7 days of inactivity)
  90
  91 removePin
  92 ~~~~~~~~~
  93 Remove the registration lock pin.
  94
  95 link
  96 ~~~~
  97 Link to an existing device, instead of registering a new number.  This shows a
  98 "tsdevice:/…" URI. If you want to connect to another signal-cli instance, you can
  99 just use this URI. If you want to link to an Android/iOS device, create a QR code
 100 with the URI (e.g. with qrencode) and scan that in the Signal app.
 101
 102 *-n* NAME, *--name* NAME::
 103         Optionally specify a name to describe this new device. By default "cli" will
 104         be used.
 105
 106 addDevice
 107 ~~~~~~~~~
 108 Link another device to this device. Only works, if this is the master device.
 109
 110 *--uri* URI::
 111         Specify the uri contained in the QR code shown by the new device.
 112
 113 listDevices
 114 ~~~~~~~~~~~
 115 Show a list of connected devices.
 116
 117 removeDevice
 118 ~~~~~~~~~~~~
 119 Remove a connected device. Only works, if this is the master device.
 120
 121 *-d* DEVICEID, *--deviceId* DEVICEID::
 122         Specify the device you want to remove. Use listDevices to see the deviceIds.
 123
 124 send
 125 ~~~~
 126 Send a message to another user or group.
 127
 128 RECIPIENT::
 129         Specify the recipients’ phone number.
 130
 131 *-g* GROUP, *--group* GROUP::
 132         Specify the recipient group ID in base64 encoding.
 133
 134 *-m* MESSAGE, *--message* MESSAGE::
 135         Specify the message, if missing, standard input is used.
 136
 137 *-a* [ATTACHMENT [ATTACHMENT ...]], *--attachment* [ATTACHMENT [ATTACHMENT ...]]::
 138         Add one or more files as attachment.
 139
 140 *-e*, *--endsession*::
 141         Clear session state and send end session message.
 142
 143 receive
 144 ~~~~~~~
 145 Query the server for new messages. New messages are printed on standardoutput and
 146 attachments are downloaded to the config directory.
 147
 148 *-t* TIMEOUT, *--timeout* TIMEOUT::
 149         Number of seconds to wait for new messages (negative values disable timeout).
 150         Default is 5 seconds.
 151 *--ignore-attachments*::
 152         Don’t download attachments of received messages.
 153 *--json*::
 154         Output received messages in json format, one object per line.
 155
 156 updateGroup
 157 ~~~~~~~~~~~
 158 Create or update a group.
 159
 160 *-g* GROUP, *--group* GROUP::
 161         Specify the recipient group ID in base64 encoding. If not specified, a new
 162         group with a new random ID is generated.
 163
 164 *-n* NAME, *--name* NAME::
 165         Specify the new group name.
 166
 167 *-a* AVATAR, *--avatar* AVATAR::
 168         Specify a new group avatar image file.
 169
 170 *-m* [MEMBER [MEMBER ...]], *--member* [MEMBER [MEMBER ...]]::
 171         Specify one or more members to add to the group.
 172
 173 quitGroup
 174 ~~~~~~~~~
 175 Send a quit group message to all group members and remove self from member list.
 176
 177 *-g* GROUP, *--group* GROUP::
 178         Specify the recipient group ID in base64 encoding.
 179
 180 listGroups
 181 ~~~~~~~~~~~
 182 Show a list of known groups.
 183
 184 *-d*, *--detailed*::
 185         Include the list of members of each group.
 186
 187 listIdentities
 188 ~~~~~~~~~~~~~~
 189 List all known identity keys and their trust status, fingerprint and safety
 190 number.
 191
 192 *-n* NUMBER, *--number* NUMBER::
 193         Only show identity keys for the given phone number.
 194
 195 trust
 196 ~~~~~
 197 Set the trust level of a given number. The first time a key for a number is seen,
 198 it is trusted by default (TOFU). If the key changes, the new key must be trusted
 199 manually.
 200
 201 number::
 202         Specify the phone number, for which to set the trust.
 203
 204 *-a*, *--trust-all-known-keys*::
 205         Trust all known keys of this user, only use this for testing.
 206
 207 *-v* VERIFIED_FINGERPRINT, *--verified-fingerprint* VERIFIED_FINGERPRINT::
 208         Specify the safety number or fingerprint of the key, only use this option if you have verified
 209         the fingerprint.
 210
 211
 212 daemon
 213 ~~~~~~
 214 signal-cli can run in daemon mode and provides an experimental dbus interface. For
 215 dbus support you need jni/unix-java.so installed on your system (Debian:
 216 libunixsocket-java ArchLinux: libmatthew-unix-java (AUR)).
 217
 218 *--system*::
 219         Use DBus system bus instead of user bus.
 220 *--ignore-attachments*::
 221         Don’t download attachments of received messages.
 222
 223
 224 Examples
 225 --------
 226
 227 Register a number (with SMS verification)::
 228     signal-cli -u USERNAME register
 229
 230 Verify the number using the code received via SMS or voice::
 231     signal-cli -u USERNAME verify CODE
 232
 233 Send a message to one or more recipients::
 234     signal-cli -u USERNAME send -m "This is a message" [RECIPIENT [RECIPIENT ...]] [-a [ATTACHMENT [ATTACHMENT ...]]]
 235
 236 Pipe the message content from another process::
 237     uname -a | signal-cli -u USERNAME send [RECIPIENT [RECIPIENT ...]]
 238
 239 Create a group::
 240         signal-cli -u USERNAME updateGroup -n "Group name" -m [MEMBER [MEMBER ...]]
 241
 242 Add member to a group::
 243         signal-cli -u USERNAME updateGroup -g GROUP_ID -m "NEW_MEMBER"
 244
 245 Leave a group::
 246         signal-cli -u USERNAME quitGroup -g GROUP_ID
 247
 248 Send a message to a group::
 249         signal-cli -u USERNAME send -m "This is a message" -g GROUP_ID
 250
 251 Trust new key, after having verified it::
 252     signal-cli -u USERNAME trust -v FINGER_PRINT NUMBER
 253
 254 Trust new key, without having verified it. Only use this if you don't care about security::
 255     signal-cli -u USERNAME trust -a NUMBER
 256
 257 Files
 258 -----
 259 The password and cryptographic keys are created when registering and stored in the
 260 current users home directory, the directory can be changed with *--config*:
 261
 262 `$XDG_DATA_HOME/signal-cli/` (`$HOME/.local/share/signal-cli/`)
 263
 264 For legacy users, the old config directories are used as a fallback:
 265
 266     $HOME/.config/signal/
 267
 268     $HOME/.config/textsecure/
 269
 270
 271 Authors
 272 -------
 273
 274 Maintained by AsamK <asamk@gmx.de>, who is assisted by other open
 275 source contributors. For more information about signal-cli development, see
 276 <https://github.com/AsamK/signal-cli>.