gitwtfhub

wtf is weflow?

jacklilyhello/weflow — explained in plain English

Analysis updated 2026-05-18

79TypeScriptAudience · generalComplexity · 2/5Setup · easy

TL;DR

A local desktop app that reads your own WeChat chat history and turns it into exports, statistics, and a shareable annual report.

Mindmap

mindmap
  root((WeFlow))
    What it does
      Reads local WeChat data
      Exports chat history
      Generates annual reports
    Tech stack
      TypeScript
      Node.js
      HTTP API
    Use cases
      Export to HTML JSON
      Yearly reports
      Moments decryption
    Audience
      WeChat users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Export your own WeChat chat history to JSON, HTML, Markdown, Excel, or CSV.

REASON 2

Generate a personal annual report and statistics from your WeChat conversations.

REASON 3

Decrypt and preview images, videos, and short live photos from your Moments posts.

REASON 4

Pull your local WeChat message data into another tool through the built-in HTTP API.

What's in the stack?

TypeScriptNode.js

How it stacks up

jacklilyhello/weflowalpha-vector-core/polymarket-arbitrage-trading-botalpha-vector-core/polymarket-trading-bot
Stars797979
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/54/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires WeChat version 4.0 or newer installed locally, prebuilt installers exist for Windows, Apple Silicon Mac, and Linux.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Help me install WeFlow on my Mac and connect it to my local WeChat 4.0 data.
Prompt 2
Show me how to export my WeChat chat history to Excel using WeFlow.
Prompt 3
Explain how to generate a yearly WeChat report for a specific friend with WeFlow.
Prompt 4
Walk me through building WeFlow from source with npm.

Frequently asked questions

wtf is weflow?

A local desktop app that reads your own WeChat chat history and turns it into exports, statistics, and a shareable annual report.

What language is weflow written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

How hard is weflow to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is weflow for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.