ByteZone
Back to listClaim this project

fanyuantaierAutomation & workflows

Wechatauto Replica

wechatauto-replica

An automation library for WeChat 4.x Windows client, enabling message reading, history export, and automated sending via local database decryption and hybrid UI drivers.

  • Backend
  • QA / Testing
  • Operations
  • Automation
  • Data analysis
  • Library/framework
  • Windows
  • Runs locally
Open websiteView on GitHub
wechatauto-replica screenshot
Popularity
81 Stars
GitHub stars
Recent activity
8/21/2026
Updated in the last 30 days
License
APACHE-2.0
Permissive

Why it matters

We look beyond stars: what problem it solves, whether it creates real utility, and what makes its approach worth noticing.

Last 90 days

Problem

WeChat 4.x introduced a custom rendering engine that lacks standard accessibility nodes, breaking existing UIAutomation-based tools like wxauto. This project addresses the resulting gap in desktop client automation.

Practical value

It enables direct local database decryption for reading messages, real-time polling, and a hybrid UIA/OCR driver for sending. However, sending remains a GUI-bound operation that fails when the desktop is locked.

Innovation / differentiation

It bypasses UI limitations by scanning process memory for SQLCipher keys to decrypt databases directly, and dynamically patches the Qt accessibility flag in Weixin.dll to restore the UIA tree, using OCR as a fallback.

Leverage potential

By offering a Python API compatible with the classic wxauto style, it allows existing scripts to adapt to WeChat 4.x with minimal rewrite effort, saving developers from building low-level hooks.

Why now

Released at a critical juncture as WeChat 4.x rolls out and older versions deprecate, offering a timely solution when legacy automation methods are actively failing.

Community activity

In the last 90 days there were 9 new issues and 1 pull requests; the bounded issue/PR samples include 8 issue authors and 1 PR contributors, with 20 releases.

Maintainer responsiveness

The 9-issue window sample had a 11% close rate, and the 1-pull-request sample had a 0% merge rate. Maintainer-comment observations covered only 100% of that issue sample, so response rate and first-response speed are not reported.

1 contributors in PR sample20 releasesPR merge rate 0% · 1 sampled in window

Key highlights

  • Direct local encrypted database reading via SQLCipher 4
  • Full chat history export and real-time message listening
  • Hybrid UIA and OCR driver for automated messaging

Quick start

How it is installed, how hard it is, and where to start.

Where it runs

Runs locally

Difficulty

Medium — some setup needed

Runs locally
  1. 01Install the project dependencies.
  2. 02Ensure the WeChat client is logged in, then run Python scripts using the WeChatDB class to access local databases.
  3. 03Use the quick_send function to perform automated message sending.

Best for

  • Developers who want to try it on their machine

More about it

wechatauto-replica is an automation library for the WeChat 4.x Windows client. Since WeChat 4.x uses self-drawn UI rendering, traditional accessibility tools fail to retrieve the control tree. This project bypasses these limitations by decrypting local SQLite databases for message reading and employing a hybrid UIA-activation and OCR-fallback driver for automated sending.

Sources

Each field shows its status and source — expand to review.

14 · Expand

  • capability tags

    Verified

    automation, data_analysis

    Source: admin_cms · cms editor · 8/22/2026

  • editor note

    Verified

    {"en":"This project addresses the breakdown of traditional automation tools caused by WeChat 4.x's self-drawn UI. It uses memory scanning for database keys and OCR-assisted drivers, making it suitable for developers needing deep data access or automated interactions.","zh":"该项目专门解决微信 4.x 客户端因自绘 UI 导致传统自动化工具失效的问题。它通过内存扫描获取数据库密钥并结合 OCR 辅助操作，适合需要深度数据分析或自动化交互的开发者。"}

    Source: admin_cms · cms editor · 8/22/2026

  • how to use

    Verified

    {"steps":[{"en":"Install the project dependencies.","zh":"安装项目依赖库。"},{"en":"Ensure the WeChat client is logged in, then run Python scripts using the WeChatDB class to access local databases.","zh":"确保微信客户端已登录，运行 Python 脚本通过 WeChatDB 类读取本地数据库。"},{"en":"Use the quick_send function to perform automated message sending.","zh":"使用 quick_send 函数进行自动化消息发送。"}],"installAt":"local","difficulty":"medium"}

    Source: admin_cms · cms editor · 8/22/2026

  • intro

    Verified

    {"en":"wechatauto-replica is an automation library for the WeChat 4.x Windows client. Since WeChat 4.x uses self-drawn UI rendering, traditional accessibility tools fail to retrieve the control tree. This project bypasses these limitations by decrypting local SQLite databases for message reading and employing a hybrid UIA-activation and OCR-fallback driver for automated sending.","zh":"wechatauto-replica 是一款针对微信 4.x Windows 客户端的自动化库。由于微信 4.x 采用了自绘 UI 渲染，传统的 UI 自动化工具无法获取控件树，本项目通过直接解密本地 SQLite 数据库实现消息读取，并利用 UIA 激活与 OCR 辅助实现自动化发送，从而绕过 UI 限制。"}

    Source: admin_cms · cms editor · 8/22/2026

  • Latest release

    Verified

    v1.1.6.3

    Source: GitHub API · latest_release=v1.1.6.3 · 8/22/2026

  • License

    Verified

    Apache-2.0

    Source: GitHub API · license.spdx_id=Apache-2.0 · 8/22/2026

  • needs api key

    Verified

    No

    Source: admin_cms · cms editor · 8/22/2026

  • One-liner

    Verified

    {"en":"An automation library for WeChat 4.x Windows client, enabling message reading, history export, and automated sending via local database decryption and hybrid UI drivers.","zh":"专为微信 4.x Windows 客户端设计的自动化工具，通过本地数据库解密与 UI 混合驱动实现消息读取、导出及自动发送。"}

    Source: admin_cms · cms editor · 8/22/2026

  • Platforms

    Verified

    windows

    Source: admin_cms · cms editor · 8/22/2026

  • Category hint

    Inferred from materials

    ai-apps

    Source: Project README · hint=ai-apps · 8/18/2026

  • product forms

    Verified

    library_framework

    Source: admin_cms · cms editor · 8/22/2026

  • role tags

    Verified

    backend, qa, operations

    Source: admin_cms · cms editor · 8/22/2026

  • supports local

    Verified

    Yes

    Source: admin_cms · cms editor · 8/22/2026

  • supports self host

    Verified

    No

    Source: admin_cms · cms editor · 8/22/2026

Related projects

Other verified projects matched by category, capabilities, and intended roles.

woodpecker

A self-hosted, plugin-extensible CI/CD engine with SQLite available by default for the server and a focused pipeline workflow.

Same Automation & workflows categoryBoth support Automation

Rundeck

A self-hosted runbook automation service with web, CLI, and API interfaces for turning operational procedures into repeatable jobs.

Same Automation & workflows categoryBoth support Automation

agent-device

Mobile app automation and verification for AI coding agents, enabling live interaction and testing across iOS, Android, HarmonyOS, and more.

Same Automation & workflows categoryBoth support Automation

qwen-audio-agent

A real-time voice runtime for AI Agents that supports full-duplex interaction while executing background tasks without interrupting the conversation.

Same Automation & workflows categoryBoth support Automation

dsh-chat-import

Import conversation histories from 12 AI agents like Claude Code, Cursor, and ChatGPT into DeepSeek Harness with full-fidelity resume and sync capabilities.

Same Automation & workflows categoryBoth support Automation

hh-ai-agent

Job-search agent that finds HH.ru vacancies, evaluates them with an LLM, generates cover letters, and sends suitable matches to Telegram.

Same Automation & workflows categoryBoth support Automation