{"id":21838,"library":"pywxdump","title":"PyWxDump","description":"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).","status":"active","version":"3.1.46","language":"python","source_language":"en","source_url":"https://github.com/xaoyaoo/PyWxDump","tags":["wechat","wx","decrypt","forensics","data-extraction","windows"],"install":[{"cmd":"pip install pywxdump","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Used for process detection (WeChat process)","package":"psutil","optional":false},{"reason":"Memory reading for key extraction","package":"pymem","optional":false},{"reason":"Cryptographic operations for decrypting databases","package":"pycryptodome","optional":false}],"imports":[{"note":"Main class for initialization and extraction.","symbol":"WxDump","correct":"from pywxdump import WxDump"}],"quickstart":{"code":"from pywxdump import WxDump\n\nwd = WxDump()\n# auto-detect WeChat process, extract decrypted key, and init\naccounts = wd.get_accounts()\nprint(accounts)\n# Example output: [{'wxid': 'wxid_xxx', 'mobile': '', 'name': 'User', 'email': ''}]\n# Then use account info to access databases\n","lang":"python","description":"Basic usage: initialize WxDump, get accounts (WeChat profiles), then proceed to decrypt and query databases."},"warnings":[{"fix":"Import `WxDump` from `pywxdump` and use its methods (e.g., `WxDump().__init__()` auto-extracts key).","message":"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.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Replace `get_wx_info()` with `wd = WxDump(); wd.get_accounts()`.","message":"The `get_wx_info` function is deprecated since v3.0.0. Use `WxDump.get_accounts()` instead.","severity":"deprecated","affected_versions":">=3.0.0 <3.2.0"},{"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).","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Run Python script as Administrator, or temporarily disable real-time protection.","message":"Antivirus or Windows Defender may block memory reading (pymem). Run as administrator if you encounter permission errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install dependencies: `pip install pywxdump[full]` or `pip install pymem`.","cause":"Missing dependency pymem. It is required for memory reading.","error":"ModuleNotFoundError: No module named 'pymem'"},{"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.","cause":"WeChat process not found or not logged in, or unsupported WeChat version.","error":"pywxdump.exceptions.WxKeyError: Unable to retrieve WeChat key"},{"fix":"Run Python script as Administrator.","cause":"Insufficient permissions to read process memory (pymem requires admin).","error":"WinError 5: Access is denied"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}