# cluic/wxauto **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/cluic-wxauto).** 7,140 stars · 1,368 forks · Python · Apache-2.0 ## Links - GitHub: https://github.com/cluic/wxauto - Homepage: https://wxauto.org - awesome-repositories: https://awesome-repositories.com/repository/cluic-wxauto.md ## Topics `automatic` `python` `rpa` `wechat` `weixin` ## Description wxauto is a Python library and bot framework designed for the programmatic control of the WeChat Windows desktop client. It functions as a wrapper that enables the automation of messaging and social feed functions by simulating user interface interactions. The library distinguishes itself by providing a bridge between network requests and local UI automation, allowing users to expose automation capabilities via a web interface. It utilizes background execution and simulated system-level inputs to trigger application events without moving the physical mouse cursor. The project covers extensive communication capabilities, including the transmission of text, multimedia, and rich link cards, as well as message monitoring and history retrieval. It provides tools for contact and group management, social feed interaction such as posting and liking, and content processing through optical character recognition and markdown conversion. The framework also includes system-level utilities for window-state management, application dialog interaction, and the configuration of operational parameters like timeouts and interface offsets. ## Tags ### Networking & Communication - [Bot Frameworks](https://awesome-repositories.com/f/networking-communication/wechat-automation-tools/bot-frameworks.md) — Provides a structured framework for building automated bots that interact with WeChat users and groups. - [Messaging Automation](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation.md) — Sends and receives messages by simulating user interface interactions within the desktop client. ([source](https://cdn.jsdelivr.net/gh/cluic/wxauto@main/README.md)) - [Messaging Event Monitoring](https://awesome-repositories.com/f/networking-communication/messaging-event-monitoring.md) — Attaches callback functions to chat windows to trigger actions when new messages arrive. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) - [Rich Embed Messages](https://awesome-repositories.com/f/networking-communication/messaging-exchange-frameworks/rich-message-types/rich-embed-messages.md) — Enables sending URLs as structured rich link cards with optional accompanying text. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) - [Text Message Transmission](https://awesome-repositories.com/f/networking-communication/text-message-transmission.md) — Transmits text, files, URL cards, and quoted responses to specific chats using remote requests. ([source](https://docs.wxauto.org/plugin/http.html)) - [WeChat Automation Tools](https://awesome-repositories.com/f/networking-communication/wechat-automation-tools.md) — Provides programmable tools for managing account settings and automating interactions for personal WeChat profiles. - [WeChat Message Processing](https://awesome-repositories.com/f/networking-communication/wechat-message-processing.md) — Automates the processing of WeChat communications, including extracting timestamps and downloading profile images. ([source](https://docs.wxauto.org/update/wxautox4.html)) - [Social Media Posting](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/communication-platforms/social-media-integrations/social-media-posting.md) — Enables publishing text and multimedia updates directly to the user's social feed. ([source](https://docs.wxauto.org/docs/example.html)) - [Group Chat Administration](https://awesome-repositories.com/f/networking-communication/group-chat-administration.md) — Controls group names, announcements, and member nicknames while inviting new participants. ([source](https://docs.wxauto.org/update/wxautox4.html)) - [UI Automation Bridges](https://awesome-repositories.com/f/networking-communication/http-request-dispatchers/ui-automation-bridges.md) — Provides a web server that translates HTTP requests into local UI automation sequences for remote control. - [History Retrieval](https://awesome-repositories.com/f/networking-communication/messaging-channel-management/history-retrieval.md) — Fetches a specified number of past messages by scrolling through the conversation history. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) - [Messaging File Transfers](https://awesome-repositories.com/f/networking-communication/messaging-file-transfers.md) — Provides the ability to send individual files, images, or directories to contacts within the messaging client. ([source](https://docs.wxauto.org/plugin/mcp.html)) - [Message Forwarding Utilities](https://awesome-repositories.com/f/networking-communication/telegram-api-integrations/message-forwarding-utilities.md) — Sends a selected message to one or more recipients with an optional comment. ([source](https://docs.wxauto.org/docs/class/Message.html)) - [Remote Command Interfaces](https://awesome-repositories.com/f/networking-communication/telegram-bot-frameworks/remote-command-interfaces.md) — Exposes a web interface that allows remote triggering of local messaging actions via network requests. ([source](https://docs.wxauto.org/)) ### User Interface & Experience - [Windows UI Element Automation](https://awesome-repositories.com/f/user-interface-experience/native-ui-component-libraries/native-ui-renderers/native-windows-ui-renderers/windows-ui-element-automation.md) — Simulates user interface inputs and window navigation to control the Windows desktop client without an official API. - [Application Launch and Window Managers](https://awesome-repositories.com/f/user-interface-experience/context-menu-customizations/application-launch-menus/per-application-menu-switching/application-launch-and-window-managers.md) — Tracks and switches between active application views to ensure correct interface context for automation. - [Application Window Navigation](https://awesome-repositories.com/f/user-interface-experience/application-window-navigation.md) — Activates a specific chat window by searching for a contact name. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) - [Contextual Message Quoting](https://awesome-repositories.com/f/user-interface-experience/contextual-message-quoting.md) — Quotes a specific message and sends a response with optional text and user mentions. ([source](https://docs.wxauto.org/docs/class/Message.html)) ### Part of an Awesome List - [Messaging Multimedia Transmission](https://awesome-repositories.com/f/awesome-lists/media/media-and-files/messaging-multimedia-transmission.md) — Provides the ability to transmit audio clips, images, and videos through the desktop client. ([source](https://docs.wxauto.org/update/wxautox4.html)) ### Development Tools & Productivity - [Input Event Simulators](https://awesome-repositories.com/f/development-tools-productivity/action-execution-frameworks/multi-action-triggers/multi-press-input-triggers/input-event-simulators.md) — Triggers application events by sending system-level messages to window handles without moving the physical mouse. - [Bot Connection Initialization](https://awesome-repositories.com/f/development-tools-productivity/instance-initialization/bot-connection-initialization.md) — Handles the initial connection handshake and operational status tracking between the bot and the desktop client. ([source](https://docs.wxauto.org/plugin/mcp.html)) ### Operating Systems & Systems Programming - [Windows Desktop Automation](https://awesome-repositories.com/f/operating-systems-systems-programming/windows-desktop-automation.md) — Acts as a programmatic interface that wraps the Windows application to automate its user interface. - [Background Window Automations](https://awesome-repositories.com/f/operating-systems-systems-programming/windows-desktop-automation/background-window-automations.md) — Executes interface actions in the background without requiring the application window to be in focus. ([source](https://docs.wxauto.org/docs/issues.html)) ### Software Engineering & Architecture - [Event-Driven Callbacks](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-callbacks.md) — Executes user-defined functions automatically when the automation engine detects new incoming messages. - [Social Feed Architectures](https://awesome-repositories.com/f/software-engineering-architecture/social-feed-architectures.md) — Provides programmatic control to toggle likes on social feed entries. ([source](https://docs.wxauto.org/docs/class/Moment.html)) - [Social Feed Displays](https://awesome-repositories.com/f/software-engineering-architecture/social-feed-architectures/social-feed-displays.md) — Automates the process of opening and accessing the moments window for social timeline interaction. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) ### System Administration & Monitoring - [Chat Message Retrieval](https://awesome-repositories.com/f/system-administration-monitoring/chat-message-retrieval.md) — Fetches current window messages, historical records, or new incoming messages from the messaging client. ([source](https://docs.wxauto.org/plugin/http.html)) - [UI State Polling](https://awesome-repositories.com/f/system-administration-monitoring/polling-based-health-monitors/ui-state-polling.md) — Polls the application interface at regular intervals to detect new incoming messages or state changes. ### Testing & Quality Assurance - [UI Automation](https://awesome-repositories.com/f/testing-quality-assurance/automation-interaction-tools/ui-automation.md) — Simulates user interface interactions to manage contacts and chat sessions within the desktop application. - [Coordinate-Based Interactions](https://awesome-repositories.com/f/testing-quality-assurance/screen-swipe-simulations/coordinate-based-interactions.md) — Interacts with interface components using precise pixel offsets and window coordinate mapping. ### Artificial Intelligence & ML - [Agent Skill Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-skill-integrations.md) — Integrates external bot skills and automated responses into the messaging client. ([source](https://docs.wxauto.org/plugin/skills.html)) - [OCR-Based Extraction](https://awesome-repositories.com/f/artificial-intelligence-ml/script-conversion/ocr-based-extraction.md) — Converts image-based message content into machine-readable text using optical character recognition. ### Business & Productivity Software - [Chat](https://awesome-repositories.com/f/business-productivity-software/group-management/group-creations/chat.md) — Establishes new group conversations by specifying a list of existing contacts. ([source](https://docs.wxauto.org/docs/class/WeChat.html)) - [Social Feed Interactions](https://awesome-repositories.com/f/business-productivity-software/social-feed-interactions.md) — Allows adding text-based replies to specific entries in the user's social feed. ([source](https://docs.wxauto.org/docs/class/Moment.html)) ### Content Management & Publishing - [Social Interactions](https://awesome-repositories.com/f/content-management-publishing/social-interactions.md) — Provides a combined capability to retrieve feed information and perform engagement actions like liking and commenting. ([source](https://docs.wxauto.org/update/wxautox4.html)) ### Data & Databases - [Social Feed Scrapers](https://awesome-repositories.com/f/data-databases/data-feeds/subscription-feed-retrievers/social-feed-scrapers.md) — Retrieves social feed content by simulating scrolling through the interface at adjustable speeds. ([source](https://docs.wxauto.org/docs/class/Moment.html)) ### Graphics & Multimedia - [WeChat Media Asset Downloaders](https://awesome-repositories.com/f/graphics-multimedia/social-media-asset-downloaders/wechat-media-asset-downloaders.md) — Saves images, videos, and files from messages or quoted content to a local folder. ([source](https://docs.wxauto.org/docs/class/Message.html)) ### Security & Cryptography - [Chat Group Member Management](https://awesome-repositories.com/f/security-cryptography/automated-moderation/chat-group-member-management.md) — Programmatically adds one or multiple members to a group chat. ([source](https://docs.wxauto.org/docs/class/Chat.html))