# xaoyaoo/pywxdump

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/xaoyaoo-pywxdump).**

9,714 stars · 1,741 forks

## Links

- GitHub: https://github.com/xaoyaoo/PyWxDump
- awesome-repositories: https://awesome-repositories.com/repository/xaoyaoo-pywxdump.md

## Topics

`pywxdump` `wxdump` `wxexport`

## Description

PyWxDump is a data recovery and export utility designed to extract, decrypt, and convert proprietary mobile messaging databases into readable formats for archival and recovery. It specifically functions as a tool to read and parse encrypted SQLite databases used by WeChat to retrieve chat history and user data.

The project focuses on the preservation of conversation history and the forensic recovery of application data for archival or legal purposes. It enables the conversion of proprietary message stores into portable, open formats to prevent data loss from account deletion or device migration.

The tool's capabilities include AES-cipher decryption based on device and account identifiers, protocol-buffer parsing for binary data, and the mapping of relational database structures into JSON or CSV files. It utilizes memory-mapped file access to handle large encrypted databases during the extraction process.

## Tags

### Data & Databases

- [Portable Data Exports](https://awesome-repositories.com/f/data-databases/portable-data-exports.md) — Extracts user data from WeChat into portable files compatible with external software formats. ([source](https://github.com/xaoyaoo/PyWxDump#readme))
- [Protocol Buffers](https://awesome-repositories.com/f/data-databases/data-serialization-formats/binary-serialization-protocols/protocol-buffers.md) — Parses binary protocol buffers to translate messaging data into readable text.
- [SQLite Integration](https://awesome-repositories.com/f/data-databases/sqlite-integration.md) — Queries local SQLite database files to extract encrypted chat logs and contact information.
- [Database Extractors](https://awesome-repositories.com/f/data-databases/sqlite-integration/database-extractors.md) — Parses encrypted SQLite databases used by mobile messaging applications to retrieve user data.
- [Data Export Mappings](https://awesome-repositories.com/f/data-databases/flat-file-databases/data-export-mappings.md) — Converts internal relational database structures into portable JSON or CSV files.

### Business & Productivity Software

- [Chat Backups](https://awesome-repositories.com/f/business-productivity-software/chat-backups.md) — Saves WeChat conversations into open formats to prevent data loss.

### Security & Cryptography

- [Message Decryption](https://awesome-repositories.com/f/security-cryptography/message-decryption.md) — Provides AES-cipher decryption for sensitive message content using device and account identifiers.
- [Digital Forensics and Analysis](https://awesome-repositories.com/f/security-cryptography/security/utilities/security-tools/digital-forensics-analysis.md) — Recovers and exports application data for legal discovery and security investigations.