PyWxDump

3.1.46 verified Mon Apr 27 auth: no python

PyWxDump is a WeChat data extraction tool for Windows. It retrieves decrypted WeChat databases, chats, contacts, and multimedia from local WeChat installations. Current version 3.1.46, updated frequently (weekly/biweekly).

pip install pywxdump

Common errors

error ModuleNotFoundError: No module named 'pymem' ↓

cause Missing dependency pymem. It is required for memory reading.

fix

Install dependencies: pip install pywxdump[full] or pip install pymem.

error pywxdump.exceptions.WxKeyError: Unable to retrieve WeChat key ↓

cause WeChat process not found or not logged in, or unsupported WeChat version.

fix

Ensure WeChat is running and logged in. Check supported versions in GitHub README. If using a newer version, wait for update or downgrade WeChat.

error WinError 5: Access is denied ↓

cause Insufficient permissions to read process memory (pymem requires admin).

fix

Run Python script as Administrator.

Warnings

breaking API overhaul in v3.0.0: old class `WxBiases` and function `get_wx_key` removed. New class `WxDump` replaces them. Code relying on `from pywxdump import WxBiases` will break. ↓

fix Import `WxDump` from `pywxdump` and use its methods (e.g., `WxDump().__init__()` auto-extracts key).

deprecated The `get_wx_info` function is deprecated since v3.0.0. Use `WxDump.get_accounts()` instead. ↓

fix Replace `get_wx_info()` with `wd = WxDump(); wd.get_accounts()`.

gotcha Must run on Windows with WeChat installed and logged in. Tool reads from WeChat process memory and local files; does not work on Linux/macOS or without an active WeChat session. ↓

fix Ensure you are on Windows, WeChat is running and signed in. Use `WxDump(force_offline=False)` if you need to work with previously cached data (but decryption keys may be invalid after logout).

gotcha Antivirus or Windows Defender may block memory reading (pymem). Run as administrator if you encounter permission errors. ↓

fix Run Python script as Administrator, or temporarily disable real-time protection.

Imports

WxDump
```
from pywxdump import WxDump
```
Main class for initialization and extraction.

Quickstart

Basic usage: initialize WxDump, get accounts (WeChat profiles), then proceed to decrypt and query databases.

from pywxdump import WxDump

wd = WxDump()
# auto-detect WeChat process, extract decrypted key, and init
accounts = wd.get_accounts()
print(accounts)
# Example output: [{'wxid': 'wxid_xxx', 'mobile': '', 'name': 'User', 'email': ''}]
# Then use account info to access databases