4 **Attention**: Now requires native libsignal-client version
0.25.0
7 - New
`--text-style` and
`--quote-text-style` flags for
`send` command
10 - Fixed migration of older account files
12 ## [0.11.10] - 2023-05-11
13 **Attention**: Now requires native libsignal-client version
0.23.1
16 - Support for receiving and sending edit messages with
`--edit-timestamp`
18 ## [0.11.9.1] - 2023-04-23
21 - Fix build with Java
20
23 ## [0.11.9] - 2023-04-22
26 - Workaround issue with linking to newer app versions
28 ## [0.11.8] - 2023-04-05
31 - Added file attachment attributes to JSON output (Thanks @signals-from-outer-space)
34 - Scrub E164 number from dbus paths
35 - Fix sending large text messages to multiple recipient
36 - Fix deleting old group in dbus mode
37 - Fix issue with unknown identity serviceId
40 - Relaxed Content-Type check in http daemon mode (Thanks @cedb)
42 ## [0.11.7] - 2023-02-19
43 **Attention**: Now requires native libsignal-client version
0.22.0
46 - Fix issue with missing pni identity key
47 - Fix graalvm sqlite issue (Thanks @Marvin A. Ruder)
48 - Fix issue with forgetting recipient
51 - Allow JSON-RPC commands without account param if only one account exists
53 ## [0.11.6] - 2022-12-18
56 - Allow using data URIs for updateGroup/updateProfile
57 - New alive check endpoint for http daemon (Thanks @ced-b)
60 - Registration with voice verification now works if no system locale is set
61 - Fixed retrieving attachments in JSON RPC mode (Thanks @ced-b)
63 ## [0.11.5.1] - 2022-11-09
66 - Fix updating from older signal-cli version
68 ## [0.11.5] - 2022-11-07
69 **Attention**: Now requires native libsignal-client version
0.21.1
72 - Add
`--http` flag to
`daemon` command to provide a JSON-RPC http endpoint (
`/api/v1/rpc`). (Thanks @ced-b)
73 - The
`receive` method is now also available in JSON-RPC daemon mode, for polling new messages.
74 - Add
`getAttachment` command to get attachment file base64 encoded. (Thanks @ced-b)
75 - Add
`--disable-send-log` to disable the message send log.
76 - Add
`--story` to
`sendReaction` command, to react to stories.
77 - Add
`--story-timestamp` and
`--story-author` to
`send` command, to reply to stories.
78 - Add
`--max-messages` to
`receive` command, to only receive a certain number of messages.
81 - Send long text messages as attachment instead. This matches the behavior of the official clients.
82 - Store attachments with a file extension, for common file types.
84 ## [0.11.4] - 2022-10-19
87 - Approve/Refuse group join requests, using same interface as adding/removing members
88 - Add --ignore-stories flag to prevent receiving story messages
91 - Fixed issue with receiving messages that can't be decrypted
92 - Do not discard incoming group join messages
95 - Add code to receive new PNI after change number
97 ## [0.11.3] - 2022-10-07
100 - Fix sending messages to groups (in non-daemon mode)
101 - Fix updating from older signal-cli version
102 - Fix issue with handling decryption error message
103 - Fix graalvm native build (Thanks @bentolor)
105 ## [0.11.2] - 2022-10-06
108 - Update user agent version to work with new Signal-Server check
110 ## [0.11.1] - 2022-10-05
113 - Fix sending group messages
114 - Fix store migration issue on Windows
115 - Fix building fat jars
117 ## [0.11.0] - 2022-10-02
118 **Attention**: Now requires native libsignal-client version
0.20.0
121 - Changed meaning of
`-v` flag from
`--version` to
`--verbose`.
122 So now extended logging can be achieved with
`-vv`.
123 - Remove deprecated fallback to reading from stdin if no message body is given.
124 To read a message from stdin, use the
`--message-from-stdin` flag.
127 - Migrate PIN to new KBS enclave when Signal updates it
128 - Add
`--scrub-log` flag to remove possibly sensitive information from the log
129 - Add
`sendPaymentNotification` dbus method
132 - Fix an issue where messages were sent without sender phone number
135 - Store data except base account data in sqlite database
136 - Use new CDSI for contact discovery in compat mode
138 ## [0.10.11] - 2022-08-17
139 **Attention**: Now requires native libsignal-client version
0.19.3
142 - Output content of received story messages
144 ## [0.10.10] - 2022-07-30
145 **Attention**: Now requires native libsignal-client version
0.18.1
148 - Fix setPin/removePin commands which broke due to server side changes
149 - Workaround GraalVM
22.2.0 issue with daemon connection
151 ## [0.10.9] - 2022-07-16
154 - updateAccount command checks self number and PNI after updating account attributes
157 - Fixed small issue with syncing contacts from storage
158 - Fixed issue with opening older account files
160 ## [0.10.8] - 2022-06-13
163 - Attachments can now be given as data: URIs with base64 data instead of just file paths (Thanks @KevinRoebert)
164 - `version` command can now be used on the commandline, in addition to the
`--version` flag.
165 In the next version the current short form
`-v` will change its meaning to
`--verbose`!
168 - An account can now be registered on both LIVE and STAGING environment in the same config directory.
169 - Logging output for registering has been extended.
171 ## [0.10.7] - 2022-05-29
174 - Added profile information to
`listContacts` command output
175 - Added filter flags for
`listContacts` command
176 - New
`sendPaymentNotification` command to send payment receipt blobs
177 - New
`--given-name` and
`--family-name` parameters for
`updateContact` command
178 - Implement sending link previews with
`--preview-url`,
`--preview-title` parameters for the
`send` command
179 - New
`--send-read-receipts` parameter for
`receive` and
`daemon` commands for automatically marking received messages as read
182 - Issue with endless growing
`pre-keys-pni` data directory
184 ## [0.10.6] - 2022-05-19
185 **Attention**: Now requires native libsignal-client version
0.17
188 - Check if account is used on the environment it was registered (live or staging)
189 - New command
`deleteLocalAccountData` to delete all local data of an unregistered account
190 - New parameter
`-g` for
`listGroups` command to filter for specific groups
193 - Fix deleting a recipient which has no uuid
196 - Show warning when sending a message and no profile name has been set.
197 (A profile name may become mandatory in the future)
198 - After blocking a contact/group the profile key is now rotated
199 - Only update profile keys from authoritative group changes
201 ## [0.10.5] - 2022-04-11
202 **Attention**: Now requires native libsignal-client version
0.15
205 - New
`--ban`,
`--unban` flags for
`updateGroup` command to ban users from joining by group link
208 - Fix plain text output of blocked group ids
209 - Fix error output in case of rate limiting
210 - Fix error when creating a group with no members
211 - Fix adding recent Signal-Desktop versions as linked devices
213 ## [0.10.4.2] - 2022-03-17
215 - Crash in json output when receiving message from untrusted identity
216 - Fix multi account commands for newly created accounts
218 ## [0.10.4.1] - 2022-03-02
220 - Linking to current apps (which currently don't include a PNI identity yet)
221 - Show better error message when --target-timestamp is missing for sendReceipt
223 ## [0.10.4] - 2022-02-20
225 - Implement support for change number as linked device
226 - Add
`--message-from-stdin` flag for send command. The current behavior of
227 reading from stdin if the
`-m` flag is not given, will be removed in a future
231 - Align receive timeout behavior for dbus client with cli and JSON-RPC.
232 Timeout is reset by every incoming message
233 - Renamed
`error` field in json receive response to
`exception`
236 - Prevent a stale jsonrpc connection from interfering with message receiving
238 ## [0.10.3] - 2022-02-01
240 - MessageSendLog to cache sent message for
24h.
241 For resending messages in case the recipient fails to decrypt the message.
242 - New global
`--log-file` parameter to write logs to a separate file.
243 (
`--verbose` can be used to increase the log level)
246 - Better subscription handling for JSON-RPC
`subscribeReceive` command
249 - Output receipt data for unsealed sender receipts again
250 - Fix sending message resend requests to devices that happen to have the same deviceId
252 ## [0.10.2] - 2022-01-22
254 - Archive old sessions/sender keys when a recipient's identity key has changed
255 - Fix profile fetch with an invalid LANG variable
257 ## [0.10.1] - 2022-01-16
259 - Send group messages with sender keys (more efficient for larger groups)
260 - New command
`listStickerPacks` to display all known sticker packs
261 - New flag
`--sticker` for
`send` command to send stickers
264 - Improve exit code for message sending.
265 Exit with
0 status code if the message was sent successfully to at least
266 one recipient, otherwise exit with status code
2 or
4 (for untrusted).
267 - Download profiles in parallel for improved perfomance
268 - `--verbose` flag can be specified multiple times for additional log output
269 - Enable more security options for systemd service file
270 - Rename sandbox to staging environment, to match the upstream name.
273 - The first incoming message after registration can now always be decrypted successfully
274 - Ignore decryption failures from blocked contacts and don't send a resend request.
276 ## [0.10.0] - 2021-12-11
277 **Attention**: Now requires Java
17 and libsignal-client version
0.11
280 - The daemon command now provides a JSON-RPC based socket interface (
`--socket` and
`--tcp`)
281 - New daemon command flag
`--receive-mode` to configure when messages are received
282 - New daemon command flag
`--no-receive-stdout` to prevent outputting messages on stdout
283 - New command
`listAccounts` that lists all registered local accounts
284 - New command
`removeContact`
285 - Extend
`send` command to allow sending mentions (
`--mention`) and quotes (
`--quote-timestamp`,
`--quote-author`,
`--quote-message`,
`--quote-mention`)
286 - New dbus methods sendGroupTying, unregister, deleteAccount
287 - New dbus events MessageReceivedV2, ReceiptReceivedV2, SyncMessageReceivedV2 that provide an extras parameter with additional message info as a key/value map
288 - New dbus method sendViewedReceipt (Thanks @John Freed)
289 - New dbus object Configuration to read and update configuration values (Thanks @John Freed)
290 - Payment info in json receive output (Thanks @technillogue)
291 - `-c` alias for
`--config` (Thanks @technillogue)
294 - libzkgroup dependency is no longer required
295 - 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.
296 - Respect phone number sharing mode and unlisted state set by primary device
297 - Adapt register command to reactivate account if possible.
298 - dbus-java now uses Java
16 native unix sockets, which should provide better cross-platform compatibility
299 - 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.
302 - Registering an existing unregistered account now works reliably in daemon mode
303 - Fixed an issue with loading some old config files without UUID
304 - More reliable send behavior if some recipients are unregistered
306 ## [0.9.2] - 2021-10-24
308 - dbus
`listNumbers` method works again
311 - Improved provisioning error handling if the last steps fail
312 - Adapt behavior of receive command as dbus client to match normal mode
313 - Update captcha url for proof required handling
315 ## [0.9.1] - 2021-10-16
316 **Attention**: Now requires native libzkgroup version
0.8
319 - New command
`updateConfiguration` which allows setting configurations for linked devices
320 - Improved dbus daemon for group handling, groups are now exported as separate dbus objects
321 - Linked devices can be managed via dbus
322 - New dbus methods sendTyping and sendReadReceipt (Thanks @JtheSaw)
323 - New dbus methods submitRateLimitChallenge, isRegistered, listDevices, setExpirationTimer, sendContacts, sendSyncRequest, uploadStickerPack, setPin and removePin (Thanks @John Freed)
324 - New dbus method getSelfNumber
327 - Do not send message resend request to own device
328 - Allow message from pending member to accept group invitations
329 - Fix issue which could cause signal-cli to repeatedly send the same delivery receipts
330 - Reconnect websocket after connection loss
333 - Use new provisioning URL
`sgnl://linkdevice` instead of
`tsdevice:/`
334 - The gradle command to build a graalvm native image is now
`./gradlew nativeCompile`
336 ## [0.9.0] - 2021-09-12
337 **Attention**: Now requires native libsignal-client version
0.9
340 - Removed deprecated
`--json` parameter, use global parameter
`--output=json` instead
341 - Json output format of
`listGroups` command changed:
342 Members are now arrays of
`{"number":"...","uuid":"..."}` objects instead of arrays of strings.
343 - Removed deprecated fallback data paths, only
`$XDG_DATA_HOME/signal-cli` is used now
344 For those still using the old paths (
`$HOME/.config/signal`,
`$HOME/.config/textsecure`) you need to move those to the new location.
347 - New global parameter
`--trust-new-identities=always` to allow trusting any new identity key without verification
348 - New parameter
`--device-name` for
`updateAccount` command to change the device name (also works for the primary device)
349 - New SignalControl DBus interface, to register/verify/link new accounts
350 - New
`jsonRpc` command that provides a JSON-RPC based API on stdout/stdin
351 - Support for announcement groups
352 - New parameter
`--set-permission-send-messages` for
`updateGroup` to create an announcement group
353 - New
`sendReceipt` command to send read and viewed receipts
354 - 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.
355 - Support for reading data from remote Signal storage. Now v2 groups will be shown after linking a new device.
356 - New
`submitRateLimitChallenge` command that can be used to lift some rate-limits by solving a captcha
359 - Store identity key correctly when sending a message after a recipient has changed keys
361 ## [0.8.5] - 2021-08-07
363 - Source name is included in JSON receive output (Thanks @technillogue)
366 - Allow updateContact command to only set expiration timer without requiring a name parameter
368 ## [0.8.4.1] - 2021-06-20
370 - Incorrect error handling in register command
372 ## [0.8.4] - 2021-06-13
373 **Attention**: Now requires native libsignal-client version
0.8.1
376 - New parameters for
`updateGroup` command for group v2 features:
377 `--description`,
`--remove-member`,
`--admin`,
`--remove-admin`,
`--reset-link`,
`--link`,
`--set-permission-add-member`,
`--set-permission-edit-details`,
`--expiration`
378 - New
`--admin` parameter for
`quitGroup` to set an admin before leaving the group
379 - New
`--delete` parameter for
`quitGroup`, to delete the local group data
380 - New 'sendTyping' command to send typing indicators
383 - Fixed issue that prevented registration with invalid locales
384 - Prevent last admin of a group from leaving the group
385 - All commands now show a short description with
`--help`
386 - Now a hint is shown if messages aren't received regularly
387 - Group edit conflicts are now resolved automatically
389 ## [0.8.3] - 2021-05-13
392 - Upgrading from account files with older profiles
393 - Building native image with graalvm
395 ## [0.8.2] - 2021-05-11
397 - A manual page for the DBus interface (Thanks @bublath, @exquo)
398 - Remote message delete command (Thanks @adaptivegarage)
399 - sendSyncRequest command to request complete contact/group list from primary device
400 - New
`--delete-account` argument for unregister (Dangerous)
401 - New
`--family-name` argument for updateProfile
404 - Sending reaction to group (Thanks @adaptivegarage)
405 - Displaying of address for messages from untrusted identities
406 - Handling of recipient number or uuid changes (e.g. after account deletions)
407 - Only respond to sync requests from primary device
408 - Display of quit group messages
411 - Unlimited strength crypto is now enabled automatically for JREs that require it (Thanks @i-infra)
412 - Only one identity key is stored per recipient and updated from profile (to match app behavior)
413 - updateContact, block and unblock are now disabled for linked devices
414 - After registering an empty profile is created so new groups can be joined immediately
415 - If message decryption fails due to a broken session, the session is automatically renewed
416 - Rework account storage for better reliability
417 - Improved device linking flow
418 - Allow relinking existing account
419 - Encrypt/Decrypt device names
421 ## [0.8.1] - 2021-03-02
423 - New dbus commands: updateProfile, listNumbers, getContactNumber, quitGroup, isContactBlocked, isGroupBlocked, isMember, joinGroup (Thanks @bublath)
424 - Additional output for json format: shared contacts (Thanks @Atomic-Bean)
425 - Improved plain text output to be more consistent and synced messages are now indented
428 - Issue with broken sessions with linked devices
431 - Behavior of
`trust` command improved, when trusting a new identity key all other known keys for
432 the same number are removed.
434 ## [0.8.0] - 2021-02-14
435 **Attention**: For all signal protocol functionality an additional native library is now required:
[libsignal-client](https://github.com/signalapp/libsignal-client/).
436 See https://github.com/AsamK/signal-cli/wiki/Provide-native-lib-for-libsignal for more information.
439 - Experimental support for building a GraalVM native image
440 - Support for setting profile about text and emoji
443 - Incorrect error message when removing a non-existent profile avatar
445 ## [0.7.4] - 2021-01-19
447 - Notify linked devices after profile has been updated
450 - After registering a new account, receiving messages didn't work
451 You may have to register and verify again to fix the issue.
452 - Creating v1 groups works again
454 ## [0.7.3] - 2021-01-17
456 - `getUserStatus` command to check if a user is registered on Signal (Thanks @Atomic-Bean)
457 - Global
`--verbose` flag to increase log level
458 - Global
`--output=json` flag, currently supported by
`receive`,
`daemon`,
`getUserStatus`,
`listGroups`
459 - `--note-to-self` flag for
`send` command to send a note to linked devices
460 - More info for received messages in json output: stickers, viewOnce, typing, remoteDelete
463 - signal-cli can now be used without the username
`-u` flag
464 For daemon command all local users will be exposed as dbus objects.
465 If only one local user exists, all other commands will use that user,
466 otherwise a user has to be specified.
467 - Messages sent to self number will be sent as normal Signal messages again, to
468 send a sync message, use the new
`--note-to-self` flag
469 - Ignore messages with group context sent by non group member
470 - Profile key is sent along with all direct messages
471 - In json output unnecessary fields that are null are now omitted
474 - Disable registration lock before removing the PIN
475 - Fix PIN hash version to match the official clients.
476 If you had previously set a PIN you need to set it again to be able to unlock the registration lock later.
477 - Issue with saving account file after linking
479 ## [0.7.2] - 2020-12-31
481 - Implement new registration lock PIN with
`setPin` and
`removePin` (with KBS)
482 - Include quotes, mentions and reactions in json output (Thanks @Atomic-Bean)
485 - Retrieve avatars for v2 groups
486 - Download attachment thumbnail for quoted attachments
488 ## [0.7.1] - 2020-12-21
490 - Accept group invitation with
`updateGroup -g GROUP_ID`
491 - Decline group invitation with
`quitGroup -g GROUP_ID`
492 - Join group via invitation link
`joinGroup --uri https://signal.group/#...`
495 - Include group ids for v2 groups in json output
497 ## [0.7.0] - 2020-12-15
499 Support for groups of new type/v2
500 - Sending and receiving
501 - Updating name, avatar and adding members with
`updateGroup`
502 - Quit group and decline invitation with
`quitGroup`
503 - In the
`listGroups` output v2 groups can be recognized by the longer groupId
505 **Attention**: For the new group support to work the native libzkgroup library is required.
506 See https://github.com/AsamK/signal-cli/wiki/Provide-native-lib-for-libsignal for more information.
509 - Rare NullPointerException when receiving messages
511 ## [0.6.12] - 2020-11-22
513 - Show additional message content (view once, remote delete, mention, …) for received messages
514 - `--captcha` parameter for
`register` command, required for some IP ranges
517 - Profile keys are now stored separately from contact list
518 - Receipts from normal and unidentified messages now have the same format in json output
521 - Issue where some messages were sent with an old counter index
523 ## [0.6.11] - 2020-10-14
524 - Fix issue with receiving message reactions
526 ## [0.6.10] - 2020-09-11
527 - Fix issue when retrieving profiles
528 - Workaround issue with libzkgroup on platforms other than linux x86_64
530 ## [0.6.9] - 2020-09-10
531 - Minor bug fixes and improvements
532 - dbus functionality now works on FreeBSD
533 - signal-cli now requires Java
11
535 **Warning: this version only works on Linux x86_64, will be fixed in
0.6.10**
537 ## [0.6.8] - 2020-05-22
538 - Switch to hypfvieh dbus-java, which doesn't require a native library anymore (drops requirement of libmatthew-unix-java)
539 - Bugfixes for messages with uuids
540 - Add
`--expiration` parameter to
`updateContact` command to set expiration timer
542 ## [0.6.7] - 2020-04-03
543 - Send command now returns the timestamp of the sent message
544 - DBus daemon: Publish received sync message to SyncMessageReceived signal
545 - Fix issue with resolving e164/uuid addresses for sessions
546 - Fix pack key length for sticker upload
548 ## [0.6.6] - 2020-03-29
549 - Added listContacts command
550 - Added block/unblock commands to block contacts and groups
551 - Added uploadStickerPack command to upload sticker packs (see man page for more details)
552 - Full support for sending and receiving unidentified sender messages
553 - Support for message reactions with emojis
554 - Internal: support recipients with uuids
556 ## [0.6.5] - 2019-11-11
557 Supports receiving messages sent with unidentified sender
559 ## [0.6.4] - 2019-11-02
560 - Fix rounding error for attachment ids in json output
561 - Add additional info to json output
562 - Add commands to update profile name and avatar
563 - Add command to update contact names
565 ## [0.6.3] - 2019-09-05
566 Bug fixes and small improvements
568 ## [0.6.2] - 2018-12-16
569 - Fixes sending of group messages
571 ## [0.6.1] - 2018-12-09
572 - Added getGroupIds dbus command
573 - Use "NativePRNG" pseudo random number generator, if available
574 - Switch default data path:
575 `$XDG_DATA_HOME/signal-cli` (
`$HOME/.local/share/signal-cli`)
576 Existing data paths will continue to work (used as fallback)
578 ## [0.6.0] - 2018-05-03
580 - dbus signal for receiving messages
581 - Registration lock PIN
582 - Output quoted message
584 ## [0.5.6] - 2017-06-16
585 * new listGroups command
586 * Support for attachments with file names
587 * Support for complete contacts sync
588 * Support for contact verification sync
591 * Get/Set contact info
593 ## [0.5.5] - 2017-02-18
594 - fix receiving messages on linked devices
595 - add unregister command
597 ## [0.5.4] - 2017-02-17
598 - Fix linking of new devices
600 ## [0.5.3] - 2017-01-29
601 * New commandline paramter for receive: --ignore-attachments
602 * Updated dependencies
604 ## [0.5.2] - 2016-12-16
605 - Add support for group info requests
606 - Improve closing of file streams
608 ## [0.5.1] - 2016-11-18
609 - Support new safety numbers
(https://whispersystems.org/blog/safety-number-updates/)
611 - Support sending disappearing messages, if the recipient has activated it
613 ## [0.5.0] - 2016-08-29
614 - Check if a number is registered on Signal, before adding it to a group
615 - Prevent sending to groups that the user has quit
616 - Commands to trust new identity keys (see README)
617 - Messages from untrusted identities are stored on disk and decrypted when the user trusts the identity
618 - Timestamps shown in ISO
8601 format
620 ## [0.4.1] - 2016-07-18
621 - Fix issue with creating groups
622 - Lock config file to prevent parallel access by multiple instances of signal-cli
623 - Improve return codes, always return non-zero code, when sending failed
625 ## [0.4.0] - 2016-06-19
626 - Linking to Signal-Desktop and Signal-Android is now possible (Provisioning)
627 - Added a contact store, mainly for syncing contacts with linked devices (editing not yet possible via cli)
628 - Avatars for groups and contacts are now stored (new folder "avatars" in the config path)
630 ## [0.3.1] - 2016-04-03
631 - Fix running with Oracle JRE
8
633 - Fix unicode warning when compiling with non utf8 locale
635 ## [0.3.0] - 2016-04-02
636 - Renamed textsecure-cli to signal-cli, following the rename of libtextsecure-java to libsignal-service-java
637 - The experimental dbus interface was also renamed to org.asamk.Signal
638 - Upload new prekeys to the server, when there are less than
20 left, prekeys are needed to create new sessions
640 ## [0.2.1] - 2016-02-10
641 - Improve dbus service
642 - New command line argument --config to specify config directory
644 ## [0.2.0] - 2015-12-30
645 Added an experimental dbus interface, for sending and receiving messages (The interface is unstable and may change with future releases).
647 This release works with Java
7 and
8.
649 ## [0.1.0] - 2015-11-28
650 Add support for creating/updating groups and sending to them
652 ## [0.0.5] - 2015-11-21
653 - Add receive timeout commandline parameter
654 - Show message group info
656 ## [0.0.4] - 2015-09-22
658 ## [0.0.3] - 2015-08-07
660 ## [0.0.2] - 2015-07-08