What is weflow?

WeFlow is a desktop application that runs entirely on your own computer and lets you view, analyze, and export your WeChat chat history in real time. It reads message data directly from a local WeChat installation, version 4.0 or newer, rather than connecting to any external server, and turns that data into statistics, visual summaries, and a shareable annual report. Its main features include browsing chat history locally, decrypting and previewing images, videos, and short live photos from Moments posts, generating statistics and profiles for both one on one and group conversations, and producing a yearly report or a report focused on a single friend based on shared chat history. Messages can be exported in several formats, including JSON, HTML, Markdown, plain text, Excel, CSV, and a format compatible with a companion tool called ChatLab, which is recommended for deeper analysis of exported conversations. Other features listed include a notification popup when new messages arrive with an allow and block list, a way to keep messages visible even if the sender tries to recall them, and the ability to intercept when someone deletes or hides a Moments post so it stays viewable locally. The app can also export a list of your contacts, groups, and followed official accounts, and in some cases recover information about friends you are no longer connected to. For developers, WeFlow exposes a local HTTP API on port 5031 that mirrors its message reading features, so the exported data can be pulled into other tools or scripts. The project is written in TypeScript, ships prebuilt installers for Windows, Apple Silicon Macs, and Linux, and can also be built from source with Node and npm. It credits two other open source projects, CipherTalk and a WeChat video decryption tool, for parts of its underlying approach. The README closes with a note asking people to use the tool responsibly and in line with applicable law.