WhatsApp Crypt Tools
Open sourceActive
Latest GitHub release v0.1.0 (2024-08-23); PyPI lists the same 0.1.0 uploaded 2024-08-23. The default branch has continued to receive commits from the maintainer, latest 2026-10-27, and its CHANGELOG carries an Unreleased section, so the released package is older than the repository. Not tested.
WhatsApp Crypt Tools is a set of Python command-line tools (and, on the unreleased main branch, a small window, wagui) that decrypt, and in beta also encrypt, WhatsApp and WhatsApp Business .crypt12, .crypt14 and .crypt15 backup files. Decryption needs the key file or the 64-character key. It also reports header information about a backup. The README points users wanting a more complete WhatsApp forensics suite to another project and describes no evidence-handling workflow.
Facts
| Website | github.com |
|---|---|
| Vendor | Davide Palma (ElDavoo) and contributors |
| Licence | Open source (GPL-3.0 (GPLv3 text in the repository LICENSE file; GitHub reports GPL-3.0; the PyPI classifier reads 'GPLv3 or later')) |
| Category | Artefact parsers |
| Functions | Decoding, Parsing |
| Targets | Android |
| Runs on | Python 3 (pip install wa-crypt-tools), Windows, macOS, Linux |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2026-10-27 · Latest maintainer commit on the default branch (drop Python 3.10, add 3.15 to the CI matrix); latest release v0.1.0 published 2024-08-23 [github.com] |
| GitHub activity | ElDavoo/wa-crypt-tools · 1,203 stars · last push 2026-11-09 · latest release v0.1.0 (2024-08-23) · checked 2026-11-10 |
Capabilities
- Decrypts WhatsApp and WhatsApp Business .crypt12, .crypt14 and .crypt15 files (wadecrypt); the README says decryption requires the key file or the 64-character key. [github.com]
- On the unreleased main branch, the key may also be supplied as a screenshot read through an optional OCR extra. [github.com]
- Includes wainfo (information about a backup file), wacreatekey (create key files), waguess (described as a hacky way to try to decrypt backups), waencrypt (encryption, labelled BETA); the main-branch README also lists the wagui window (unreleased, main branch only) and documents use as the Python library wa_crypt_tools. [github.com]
- On the repository's main branch (unreleased), wadecrypt stops when a decrypted result fails its authentication check; the README says -f / --force writes the output anyway, but that such output has failed its check and nothing vouches for it being the original data. [github.com]
- The CHANGELOG, under Version 0.2.0, says earlier versions did not enforce the authentication check and accepted --force but ignored it. [github.com]
- The README states the last tested stable WhatsApp version as 2.26.34.7 (tested against backups from a device running it) and WhatsApp Business as 2.24.23.78, not retested. [github.com]
Limitations
- The README answers 'Can I decrypt a backup without a key file?' with 'NO!'. The WhatsApp account password does not decrypt a backup: the README says it only protects the key held by WhatsApp's servers. [github.com]
- The README says that methods for obtaining the key beyond copying it from a rooted device (/data/data/com.whatsapp/files/key, or encrypted_backup.key for crypt15) or using a saved 64-digit key are not in the project's scope, and that issues asking for them will be closed. [github.com]
- Encryption (waencrypt) is described as beta and 'more complex and untested'; the README advises supplying a reference backup from the same account. [github.com]
- The repository CHANGELOG lists, under Unreleased, that Python 3.11 or newer is required. The latest tagged release and the latest PyPI upload predate this change. [github.com]
Links
Related tools
- WhatsApp Chat Exporter · Artefact parsers
- Elcomsoft Explorer for WhatsApp · Acquisition
Sources
- GitHub: ElDavoo/wa-crypt-tools (README, LICENSE) (github.com)
- GitHub: wa-crypt-tools CHANGELOG (github.com)
- GitHub: wa-crypt-tools releases (github.com)
- GitHub: wa-crypt-tools commit history (github.com)
- PyPI JSON: wa-crypt-tools release list (0.1.0, 2024-08-23) (pypi.org)
Reviewed . Spotted an error? See the corrections policy.