How to Extract Your WeChat Encryption Key with WetraceTooleric

WeChat stores your message history in a local SQLite database encrypted with SQLCipher. To read your own messages with any third-party tool — including backup utilities or search apps — you first need the encryption key that WeChat uses to lock that database.

Getting that key used to mean running commands in a terminal, attaching debuggers, or following fragile step-by-step guides that broke with every WeChat update. WetraceTool wraps the underlying wetrace hook into a simple four-step wizard. You click through the steps, log in to WeChat when prompted, and the key appears on screen ready to copy.

What you need

• Windows 10 or 11 (64-bit)
• WeChat (国际版) or Weixin (微信) installed
• WetraceTool — download the latest WetraceTool-Setup-*.exe installer from here.

Step 0 — Run the installer

Double-click the installer and follow the prompts. After the installation, search up "WetraceTool", the run it. Because WetraceTool needs to attach to the WeChat process, Windows will show a User Account Control dialog asking for elevated permissions. Click Yes to continue.

This is expected — the tool cannot capture the key without administrator-level access to the running WeChat process.

Step 1 — Start WeChat

Once WetraceTool opens you will see the four-step wizard on the left and the current step's instructions on the right.

Click Launch WeChat to start WeChat automatically, or just open WeChat yourself — the app polls for it in the background and will advance to the next step the moment it detects WeChat is running.

Step 2 — Get to the WeChat login screen

For the key capture to work, WeChat must be sitting at the login screen (showing a QR code or an account avatar with a "Log in" button) at the moment you sign in. If you are already logged in, you need to log out first.

The app gives you the exact steps:

1. Click the profile / avatar icon in the bottom-left corner of WeChat
2. Go to Settings → My Account → Log out
3. Confirm the log out

Once you can see the QR code or the login button in WeChat, click I can see the login screen — Continue ✓ in WetraceTool.

Step 3 — Extract the key

This is the active capture step. WetraceTool starts the background hook service and then waits for you to log in to WeChat. You have 60 seconds from the moment you click Start.

When the Start — I'm ready to log in button becomes active (it will briefly show "Starting background service…" while the hook initialises), click it and then immediately switch to WeChat and log in. WeChat may reopen a login window — that is normal and expected. Just sign in as you normally would; the key is captured automatically the instant WeChat unlocks its database.

Tip: Have WeChat's QR code scaner (Discover -> Scan) ready on your phone before clicking Start so you don't lose time.

Step 4 — Copy your key

If the capture succeeded, the wizard advances to the final screen showing your encryption key and, where it can be detected automatically, the path to your WeChat message database.

Click Copy Key to copy the encryption key to your clipboard. If the database path was detected, you can copy that too with the Copy button beneath it. Both values are what you will need to open your WeChat database with a tool like decrypt_sync or any SQLCipher-aware client.

You can close WetraceTool once you have copied what you need.

Troubleshooting

Timer runs out with no key captured Make sure you log in to WeChat after clicking Start, not before. The hook only listens from the moment you click Start.

"Starting background service…" button never becomes active WetraceTool needs elevated permissions to attach to the WeChat process. Close the app, right-click the shortcut, and choose Run as administrator.

WeChat is not detected automatically Open Task Manager and check whether Weixin.exe or WeChat.exe is listed under running processes. If neither appears, WeChat may not have launched correctly — try starting it manually.

Key extraction fails with a connection error The background hook service failed to start or was blocked. Close WetraceTool, reopen it as Administrator, and work through the steps again from the beginning.