pywxdump

library3.1.46pypypiunverified

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).

data database

pip install pywxdump

github ↗package ↗

INSTALL

IMPORT

SIG · PYWXDUMP

pywxdump

datapythonv3.1.46

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WxDump

✓ from pywxdump import WxDump

Main class for initialization and extraction.

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

wxdump --version

Debug

Known issues

breakingAPI 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).

affects: >=3.0.0

deprecatedThe `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()`.

affects: >=3.0.0 <3.2.0

gotchaMust 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).

affects: all

gotchaAntivirus 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.

affects: all

Upgrade

Version history

3.1.46latest on PyPI · released Oct 15, 2025

Audit

Dependencies

psutilrequiredUsed for process detection (WeChat process)

pymemrequiredMemory reading for key extraction

pycryptodomerequiredCryptographic operations for decrypting databases

Agent activity

10 hits · last 30 days

node

Resources

githubhttps://github.com/xaoyaoo/PyWxDump ↗

packagehttps://pypi.org/project/pywxdump/ ↗