5 - Send group messages with sender keys (more efficient for larger groups)
8 - Improve exit code for message sending.
9 Exit with
0 status code if the message was sent successfully to at least
10 one recipient, otherwise exit with status code
2 or
4 (for untrusted).
11 - Download profiles in parallel for improved perfomance
12 - `--verbose` flag can be specified multiple times for additional log output
15 - The first incoming message after registration can now always be decrypted successfully
17 ## [0.10.0] - 2021-12-11
18 **Attention**: Now requires Java
17 and libsignal-client version
0.11
21 - The daemon command now provides a JSON-RPC based socket interface (
`--socket` and
`--tcp`)
22 - New daemon command flag
`--receive-mode` to configure when messages are received
23 - New daemon command flag
`--no-receive-stdout` to prevent outputting messages on stdout
24 - New command
`listAccounts` that lists all registered local accounts
25 - New command
`removeContact`
26 - Extend
`send` command to allow sending mentions (
`--mention`) and quotes (
`--quote-timestamp`,
`--quote-author`,
`--quote-message`,
`--quote-mention`)
27 - New dbus methods sendGroupTying, unregister, deleteAccount
28 - New dbus events MessageReceivedV2, ReceiptReceivedV2, SyncMessageReceivedV2 that provide an extras parameter with additional message info as a key/value map
29 - New dbus method sendViewedReceipt (Thanks @John Freed)
30 - New dbus object Configuration to read and update configuration values (Thanks @John Freed)
31 - Payment info in json receive output (Thanks @technillogue)
32 - `-c` alias for
`--config` (Thanks @technillogue)
35 - libzkgroup dependency is no longer required
36 - Renamed
`-u` and
`--username` flags to
`-a` and
`--account` to prevent confusion with upcoming Signal usernames. The old flags are also still supported for now.
37 - Respect phone number sharing mode and unlisted state set by main device
38 - Adapt register command to reactivate account if possible.
39 - dbus-java now uses Java
16 native unix sockets, which should provide better cross-platform compatibility
40 - If sending to a recipient fails (e.g. unregistered) signal-cli now exits with a success exit code and prints additional information about the failure.
43 - Registering an existing unregistered account now works reliably in daemon mode
44 - Fixed an issue with loading some old config files without UUID
45 - More reliable send behavior if some recipients are unregistered
47 ## [0.9.2] - 2021-10-24
49 - dbus
`listNumbers` method works again
52 - Improved provisioning error handling if the last steps fail
53 - Adapt behavior of receive command as dbus client to match normal mode
54 - Update captcha url for proof required handling
56 ## [0.9.1] - 2021-10-16
57 **Attention**: Now requires native libzkgroup version
0.8
60 - New command
`updateConfiguration` which allows setting configurations for linked devices
61 - Improved dbus daemon for group handling, groups are now exported as separate dbus objects
62 - Linked devices can be managed via dbus
63 - New dbus methods sendTyping and sendReadReceipt (Thanks @JtheSaw)
64 - New dbus methods submitRateLimitChallenge, isRegistered, listDevices, setExpirationTimer, sendContacts, sendSyncRequest, uploadStickerPack, setPin and removePin (Thanks @John Freed)
65 - New dbus method getSelfNumber
68 - Do not send message resend request to own device
69 - Allow message from pending member to accept group invitations
70 - Fix issue which could cause signal-cli to repeatedly send the same delivery receipts
71 - Reconnect websocket after connection loss
74 - Use new provisioning URL
`sgnl://linkdevice` instead of
`tsdevice:/`
75 - The gradle command to build a graalvm native image is now
`./gradlew nativeCompile`
77 ## [0.9.0] - 2021-09-12
78 **Attention**: Now requires native libsignal-client version
0.9
81 - Removed deprecated
`--json` parameter, use global parameter
`--output=json` instead
82 - Json output format of
`listGroups` command changed:
83 Members are now arrays of
`{"number":"...","uuid":"..."}` objects instead of arrays of strings.
84 - Removed deprecated fallback data paths, only
`$XDG_DATA_HOME/signal-cli` is used now
85 For those still using the old paths (
`$HOME/.config/signal`,
`$HOME/.config/textsecure`) you need to move those to the new location.
88 - New global parameter
`--trust-new-identities=always` to allow trusting any new identity key without verification
89 - New parameter
`--device-name` for
`updateAccount` command to change the device name (also works for the main device)
90 - New SignalControl DBus interface, to register/verify/link new accounts
91 - New
`jsonRpc` command that provides a JSON-RPC based API on stdout/stdin
92 - Support for announcement groups
93 - New parameter
`--set-permission-send-messages` for
`updateGroup` to create an announcement group
94 - New
`sendReceipt` command to send read and viewed receipts
95 - Support for receiving sender key messages, mobile apps can now send messages more efficiently with server-side fan-out to groups with signal-cli members.
96 - Support for reading data from remote Signal storage. Now v2 groups will be shown after linking a new device.
97 - New
`submitRateLimitChallenge` command that can be used to lift some rate-limits by solving a captcha
100 - Store identity key correctly when sending a message after a recipient has changed keys
102 ## [0.8.5] - 2021-08-07
104 - Source name is included in JSON receive output (Thanks @technillogue)
107 - Allow updateContact command to only set expiration timer without requiring a name parameter
109 ## [0.8.4.1] - 2021-06-20
111 - Incorrect error handling in register command
113 ## [0.8.4] - 2021-06-13
114 **Attention**: Now requires native libsignal-client version
0.8.1
117 - New parameters for
`updateGroup` command for group v2 features:
118 `--description`,
`--remove-member`,
`--admin`,
`--remove-admin`,
`--reset-link`,
`--link`,
`--set-permission-add-member`,
`--set-permission-edit-details`,
`--expiration`
119 - New
`--admin` parameter for
`quitGroup` to set an admin before leaving the group
120 - New
`--delete` parameter for
`quitGroup`, to delete the local group data
121 - New 'sendTyping' command to send typing indicators
124 - Fixed issue that prevented registration with invalid locales
125 - Prevent last admin of a group from leaving the group
126 - All commands now show a short description with
`--help`
127 - Now a hint is shown if messages aren't received regularly
128 - Group edit conflicts are now resolved automatically
130 ## [0.8.3] - 2021-05-13
133 - Upgrading from account files with older profiles
134 - Building native image with graalvm
136 ## [0.8.2] - 2021-05-11
138 - A manual page for the DBus interface (Thanks @bublath, @exquo)
139 - Remote message delete command (Thanks @adaptivegarage)
140 - sendSyncRequest command to request complete contact/group list from master device
141 - New
`--delete-account` argument for unregister (Dangerous)
142 - New
`--family-name` argument for updateProfile
145 - Sending reaction to group (Thanks @adaptivegarage)
146 - Displaying of address for messages from untrusted identities
147 - Handling of recipient number or uuid changes (e.g. after account deletions)
148 - Only respond to sync requests from master device
149 - Display of quit group messages
152 - Unlimited strength crypto is now enabled automatically for JREs that require it (Thanks @i-infra)
153 - Only one identity key is stored per recipient and updated from profile (to match app behavior)
154 - updateContact, block and unblock are now disabled for linked devices
155 - After registering an empty profile is created so new groups can be joined immediately
156 - If message decryption fails due to a broken session, the session is automatically renewed
157 - Rework account storage for better reliability
158 - Improved device linking flow
159 - Allow relinking existing account
160 - Encrypt/Decrypt device names
162 ## [0.8.1] - 2021-03-02
164 - New dbus commands: updateProfile, listNumbers, getContactNumber, quitGroup, isContactBlocked, isGroupBlocked, isMember, joinGroup (Thanks @bublath)
165 - Additional output for json format: shared contacts (Thanks @Atomic-Bean)
166 - Improved plain text output to be more consistent and synced messages are now indented
169 - Issue with broken sessions with linked devices
172 - Behavior of
`trust` command improved, when trusting a new identity key all other known keys for
173 the same number are removed.
175 ## [0.8.0] - 2021-02-14
176 **Attention**: For all signal protocol functionality an additional native library is now required:
[libsignal-client](https://github.com/signalapp/libsignal-client/).
177 See https://github.com/AsamK/signal-cli/wiki/Provide-native-lib-for-libsignal for more information.
180 - Experimental support for building a GraalVM native image
181 - Support for setting profile about text and emoji
184 - Incorrect error message when removing a non-existent profile avatar
186 ## [0.7.4] - 2021-01-19
188 - Notify linked devices after profile has been updated
191 - After registering a new account, receiving messages didn't work
192 You may have to register and verify again to fix the issue.
193 - Creating v1 groups works again
195 ## [0.7.3] - 2021-01-17
197 - `getUserStatus` command to check if a user is registered on Signal (Thanks @Atomic-Bean)
198 - Global
`--verbose` flag to increase log level
199 - Global
`--output=json` flag, currently supported by
`receive`,
`daemon`,
`getUserStatus`,
`listGroups`
200 - `--note-to-self` flag for
`send` command to send a note to linked devices
201 - More info for received messages in json output: stickers, viewOnce, typing, remoteDelete
204 - signal-cli can now be used without the username
`-u` flag
205 For daemon command all local users will be exposed as dbus objects.
206 If only one local user exists, all other commands will use that user,
207 otherwise a user has to be specified.
208 - Messages sent to self number will be sent as normal Signal messages again, to
209 send a sync message, use the new
`--note-to-self` flag
210 - Ignore messages with group context sent by non group member
211 - Profile key is sent along with all direct messages
212 - In json output unnecessary fields that are null are now omitted
215 - Disable registration lock before removing the PIN
216 - Fix PIN hash version to match the official clients.
217 If you had previously set a PIN you need to set it again to be able to unlock the registration lock later.
218 - Issue with saving account file after linking
220 ## [0.7.2] - 2020-12-31
222 - Implement new registration lock PIN with
`setPin` and
`removePin` (with KBS)
223 - Include quotes, mentions and reactions in json output (Thanks @Atomic-Bean)
226 - Retrieve avatars for v2 groups
227 - Download attachment thumbnail for quoted attachments
229 ## [0.7.1] - 2020-12-21
231 - Accept group invitation with
`updateGroup -g GROUP_ID`
232 - Decline group invitation with
`quitGroup -g GROUP_ID`
233 - Join group via invitation link
`joinGroup --uri https://signal.group/#...`
236 - Include group ids for v2 groups in json output
238 ## [0.7.0] - 2020-12-15
240 Support for groups of new type/v2
241 - Sending and receiving
242 - Updating name, avatar and adding members with
`updateGroup`
243 - Quit group and decline invitation with
`quitGroup`
244 - In the
`listGroups` output v2 groups can be recognized by the longer groupId
246 **Attention**: For the new group support to work the native libzkgroup library is required.
247 See https://github.com/AsamK/signal-cli/wiki/Provide-native-lib-for-libsignal for more information.
250 - Rare NullPointerException when receiving messages
252 ## [0.6.12] - 2020-11-22
254 - Show additional message content (view once, remote delete, mention, …) for received messages
255 - `--captcha` parameter for
`register` command, required for some IP ranges
258 - Profile keys are now stored separately from contact list
259 - Receipts from normal and unidentified messages now have the same format in json output
262 - Issue where some messages were sent with an old counter index
264 ## [0.6.11] - 2020-10-14
265 - Fix issue with receiving message reactions
267 ## [0.6.10] - 2020-09-11
268 - Fix issue when retrieving profiles
269 - Workaround issue with libzkgroup on platforms other than linux x86_64
271 ## [0.6.9] - 2020-09-10
272 - Minor bug fixes and improvements
273 - dbus functionality now works on FreeBSD
274 - signal-cli now requires Java
11
276 **Warning: this version only works on Linux x86_64, will be fixed in
0.6.10**
278 ## [0.6.8] - 2020-05-22
279 - Switch to hypfvieh dbus-java, which doesn't require a native library anymore (drops requirement of libmatthew-unix-java)
280 - Bugfixes for messages with uuids
281 - Add
`--expiration` parameter to
`updateContact` command to set expiration timer
283 ## [0.6.7] - 2020-04-03
284 - Send command now returns the timestamp of the sent message
285 - DBus daemon: Publish received sync message to SyncMessageReceived signal
286 - Fix issue with resolving e164/uuid addresses for sessions
287 - Fix pack key length for sticker upload
289 ## [0.6.6] - 2020-03-29
290 - Added listContacts command
291 - Added block/unblock commands to block contacts and groups
292 - Added uploadStickerPack command to upload sticker packs (see man page for more details)
293 - Full support for sending and receiving unidentified sender messages
294 - Support for message reactions with emojis
295 - Internal: support recipients with uuids
297 ## [0.6.5] - 2019-11-11
298 Supports receiving messages sent with unidentified sender
300 ## [0.6.4] - 2019-11-02
301 - Fix rounding error for attachment ids in json output
302 - Add additional info to json output
303 - Add commands to update profile name and avatar
304 - Add command to update contact names
306 ## [0.6.3] - 2019-09-05
307 Bug fixes and small improvements
309 ## [0.6.2] - 2018-12-16
310 - Fixes sending of group messages
312 ## [0.6.1] - 2018-12-09
313 - Added getGroupIds dbus command
314 - Use "NativePRNG" pseudo random number generator, if available
315 - Switch default data path:
316 `$XDG_DATA_HOME/signal-cli` (
`$HOME/.local/share/signal-cli`)
317 Existing data paths will continue to work (used as fallback)
319 ## [0.6.0] - 2018-05-03
321 - dbus signal for receiving messages
322 - Registration lock PIN
323 - Output quoted message
325 ## [0.5.6] - 2017-06-16
326 * new listGroups command
327 * Support for attachments with file names
328 * Support for complete contacts sync
329 * Support for contact verification sync
332 * Get/Set contact info
334 ## [0.5.5] - 2017-02-18
335 - fix receiving messages on linked devices
336 - add unregister command
338 ## [0.5.4] - 2017-02-17
339 - Fix linking of new devices
341 ## [0.5.3] - 2017-01-29
342 * New commandline paramter for receive: --ignore-attachments
343 * Updated dependencies
345 ## [0.5.2] - 2016-12-16
346 - Add support for group info requests
347 - Improve closing of file streams
349 ## [0.5.1] - 2016-11-18
350 - Support new safety numbers
(https://whispersystems.org/blog/safety-number-updates/)
352 - Support sending disappearing messages, if the recipient has activated it
354 ## [0.5.0] - 2016-08-29
355 - Check if a number is registered on Signal, before adding it to a group
356 - Prevent sending to groups that the user has quit
357 - Commands to trust new identity keys (see README)
358 - Messages from untrusted identities are stored on disk and decrypted when the user trusts the identity
359 - Timestamps shown in ISO
8601 format
361 ## [0.4.1] - 2016-07-18
362 - Fix issue with creating groups
363 - Lock config file to prevent parallel access by multiple instances of signal-cli
364 - Improve return codes, always return non-zero code, when sending failed
366 ## [0.4.0] - 2016-06-19
367 - Linking to Signal-Desktop and Signal-Android is now possible (Provisioning)
368 - Added a contact store, mainly for syncing contacts with linked devices (editing not yet possible via cli)
369 - Avatars for groups and contacts are now stored (new folder "avatars" in the config path)
371 ## [0.3.1] - 2016-04-03
372 - Fix running with Oracle JRE
8
374 - Fix unicode warning when compiling with non utf8 locale
376 ## [0.3.0] - 2016-04-02
377 - Renamed textsecure-cli to signal-cli, following the rename of libtextsecure-java to libsignal-service-java
378 - The experimental dbus interface was also renamed to org.asamk.Signal
379 - Upload new prekeys to the server, when there are less than
20 left, prekeys are needed to create new sessions
381 ## [0.2.1] - 2016-02-10
382 - Improve dbus service
383 - New command line argument --config to specify config directory
385 ## [0.2.0] - 2015-12-30
386 Added an experimental dbus interface, for sending and receiving messages (The interface is unstable and may change with future releases).
388 This release works with Java
7 and
8.
390 ## [0.1.0] - 2015-11-28
391 Add support for creating/updating groups and sending to them
393 ## [0.0.5] - 2015-11-21
394 - Add receive timeout commandline parameter
395 - Show message group info
397 ## [0.0.4] - 2015-09-22
399 ## [0.0.3] - 2015-08-07
401 ## [0.0.2] - 2015-07-08