signalbackup-tools
Open sourceActive
Latest GitHub release 20261014 (2026-10-14); latest commit on the same day. No PyPI package. Not tested.
signalbackup-tools is a C++ command-line program for working with backup files created by the Signal Android application. Given a backup and its passphrase, it can dump the decrypted database and media, export conversations to HTML, TXT, CSV or XML, and merge, crop or modify backups. It is not affiliated with the Signal Foundation. The README describes no forensic workflow, and several functions rewrite backups.
Facts
| Website | github.com |
|---|---|
| Vendor | Bepaald (bepaald) and contributors |
| Licence | Open source (GPL-3.0-or-later per the source-file headers (e.g. main.cc: 'either version 3 of the License, or (at your option) any later version'); the repository LICENSE file holds the GPLv3 text and GitHub reports GPL-3.0) |
| Category | Artefact parsers |
| Functions | Decoding, Parsing, Reporting |
| Targets | Android |
| Runs on | Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2026-10-14 · Release 20261014 published; latest commit fixes decrypting empty messages from an ADB backup [github.com] |
| GitHub activity | bepaald/signalbackup-tools · 1,424 stars · last push 2026-11-03 · latest release 20261102-1 (2026-11-02) · checked 2026-11-10 |
Capabilities
- Opens a Signal Android backup file with its passphrase and can dump the decrypted database and media to a directory, dump only media attachments or avatars, or re-encrypt a directory of dumped components into a backup file. [github.com]
- Exports messages to HTML and plain text, the database tables to CSV, and messages to an XML file intended to be compatible with SMS Backup & Restore. [github.com]
- Lists threads, runs SQL queries against the database in a backup file, and attempts to fix broken backups; the README says a Signal Android format change around version 6.26 (circa July 2023) made recovery from corruption across frame boundaries impossible for newer backups. [github.com]
- Also contains functions to crop a backup to chosen threads or dates, merge backups, import from Signal Desktop, a Telegram-style JSON file or an old adb backup, and delete or replace attachments; these rewrite backup content rather than only reading it. [github.com]
Limitations
- The README says Signal's database format changes regularly and that a change occasionally breaks some functionality of the program until it is fixed; it also says the tool is provided as-is and may contain bugs. [github.com]
- The documented invocation takes the backup file and its passphrase (which can be omitted on the command line and entered at a prompt). The README does not describe recovering an unknown passphrase. [github.com]
- Importing from an old adb backup is described as working only in a few specific cases (the database itself not encrypted, and the encryption key present in the backup), and as in-progress with final testing never completed. The README also notes that some experimental functions have occasionally caused issues and points to an ERRATA file. [github.com]
- The Windows build is a command-line executable that the README says is only minimally tested; it must be run from a terminal. [github.com]
Links
Related tools
- ADB · Acquisition
- Android Backup Extractor · Artefact parsers
- ALEAPP · Artefact parsers
- Crush · Analysis
Sources
- GitHub: bepaald/signalbackup-tools (README, LICENSE) (github.com)
- GitHub: signalbackup-tools releases (github.com)
- GitHub: signalbackup-tools commit history (github.com)
Reviewed . Spotted an error? See the corrections policy.