pywxdump

What it is and what it does

PyWxDump is a forensic and backup tool for WeChat that runs on Windows to extract account credentials (nickname, account name, phone, email, encryption key), decrypt the local SQLite databases, and provide unified viewing of chat history. It includes a web interface built on fastapi and uvicorn for remote access to chat logs, and can export conversations as HTML, CSV, or backup archives.

The package operates by reading WeChat process memory to locate encryption keys and database paths, then decrypting the databases using those keys. It combines multiple database types for a complete view of chat history. The tool is designed primarily for personal backup and archival of one's own WeChat data, though the disclaimer emphasizes it is for learning purposes only and must not be used for unauthorized access or privacy violation.

Use it for:

• Back up and archive your own WeChat chat history locally before reinstalling or upgrading WeChat
• Export WeChat conversations to HTML or CSV for record-keeping or compliance purposes
• View historical chat logs through a web interface on a local network without opening WeChat
• Analyze your own chat data (word clouds, message frequency) after decryption and parsing
• Recover or migrate chat history across devices by extracting and decrypting databases

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extracts WeChat account metadata, decrypts chat databases, and provides web-based viewing and export of chat history as HTML or CSV.

Yes, if you are on Windows and need to back up or export your own WeChat data. The package has low install friction and active community interest (9675 GitHub stars). However, the aging maintenance status and Windows-only practical support are concerns. The strict disclaimer and 24-hour usage window suggest this is a specialized forensic tool—install only if you understand the legal and ethical constraints and have a legitimate backup or archival need.

Install

pywxdump on PyPI

pip install pywxdump

uv add pywxdump

poetry add pywxdump

Installing pywxdump

Before you install

Low install friction with a pure-Python wheel. Maintenance status is aging—last commit was 2025-10-20 but the package has not been updated since 2025-10-15. The 15 runtime dependencies include system-level libraries (pywin32, pyaudio) that may require additional setup on non-Windows platforms.

License in practice

MIT license permits commercial and private use with minimal restrictions. You may use, modify, and distribute the package freely provided you retain the license notice.

Quickstart

pip install pywxdump

from pywxdump import PyWxDump

# Extract WeChat account info and decrypt databases
wxdump = PyWxDump()
info = wxdump.get_wx_info()
wxdump.decrypt_db(info['key'], info['db_path'])

Windows-only; depends on pywin32 and pymem for process memory access. Requires an active WeChat installation and currently logged-in session.

Verify before relying

• Whether the package works reliably on macOS or Linux despite classifier claiming OS independence
• Current stability of the 15 runtime dependencies, particularly pywin32 and pymem on modern Windows versions
• Whether the web UI (fastapi/uvicorn stack) is fully functional in version 3.1.46 or requires separate setup

Package facts

Evidence: pywxdump-3.1.46-py3-none-any.whl

Tags

More Utilities packages