gitwtfhub

wtf is wechattweak?

sunnyyoung/wechattweak — explained in plain English

Analysis updated 2026-06-24

13,680SwiftAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A macOS command-line tool that patches WeChat to show recalled messages, block auto-updates, and run multiple accounts at the same time.

Mindmap

mindmap
  root((WeChatTweak))
    What it does
      Show recalled messages
      Block auto-updates
      Multiple accounts
    Installation
      Homebrew
      Patch command
    Integrations
      Alfred
      Raycast
    Audience
      Chinese Mac users
      WeChat power users

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

See messages that another person has recalled or deleted from a WeChat conversation on your Mac.

REASON 2

Run two or more WeChat accounts simultaneously in separate windows on a single Mac.

REASON 3

Prevent WeChat from automatically updating itself to stay on a version compatible with WeChatTweak.

REASON 4

Trigger WeChat actions from Alfred or Raycast without opening the WeChat app manually.

What's in the stack?

SwiftmacOSHomebrew

How it stacks up

sunnyyoung/wechattweakperfectlysoft/perfectaltstoreio/altstore
Stars13,68013,76913,852
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderatehard
Complexity2/53/53/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Homebrew, you must run a patch command after install, and compatibility depends on your installed WeChat version.

AGPL-3.0: free to use and modify, but any version you distribute must also be released as open source under the same license.

Wtf does this do

WeChatTweak is a command-line tool for macOS that modifies the behavior of WeChat, the popular Chinese messaging app. It is aimed at users who want a few extra controls that the official WeChat desktop app does not provide out of the box. The main things it does: it stops other people's message recalls from affecting your view (so if someone deletes a message they sent you, you can still see it), it blocks WeChat from automatically updating itself, and it lets you run multiple WeChat accounts at the same time in separate windows on the same Mac. Installation is done through Homebrew, a common package manager for macOS. You run a short install command, then run a patch command to apply the modifications to your existing WeChat installation. The project also includes a command to list which WeChat versions the tool supports. The tool has support for Alfred (a Mac productivity app) and Raycast (a similar launcher), which lets you trigger WeChat actions from those launchers directly. The repository links to a Telegram group for community discussion and a FAQ page for common questions. The README is written mostly in Chinese, and the project is targeted at Chinese-speaking Mac users who use WeChat daily. The code is released under the AGPL-3.0 license, which requires that any modifications you distribute must also be open source.

Yoink these prompts

Prompt 1
Write step-by-step instructions for installing WeChatTweak on macOS using Homebrew, including the patch command.
Prompt 2
How do I check which WeChat versions are currently supported by WeChatTweak before patching?
Prompt 3
How do I use WeChatTweak with Raycast to search WeChat contacts or open recent chats?
Prompt 4
How do I uninstall WeChatTweak and restore WeChat to its original unmodified state on macOS?

Frequently asked questions

wtf is wechattweak?

A macOS command-line tool that patches WeChat to show recalled messages, block auto-updates, and run multiple accounts at the same time.

What language is wechattweak written in?

Mainly Swift. The stack also includes Swift, macOS, Homebrew.

What license does wechattweak use?

AGPL-3.0: free to use and modify, but any version you distribute must also be released as open source under the same license.

How hard is wechattweak to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is wechattweak for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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