cluic/wxauto
Wxauto
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.
Features
- Bot Frameworks - Provides a structured framework for building automated bots that interact with WeChat users and groups.
- Windows UI Element Automation - Simulates user interface inputs and window navigation to control the Windows desktop client without an official API.
- Messaging Multimedia Transmission - Provides the ability to transmit audio clips, images, and videos through the desktop client.
- Input Event Simulators - Triggers application events by sending system-level messages to window handles without moving the physical mouse.
- Bot Connection Initialization - Handles the initial connection handshake and operational status tracking between the bot and the desktop client.
- Messaging Automation - Sends and receives messages by simulating user interface interactions within the desktop client.
- Messaging Event Monitoring - Attaches callback functions to chat windows to trigger actions when new messages arrive.
- Rich Embed Messages - Enables sending URLs as structured rich link cards with optional accompanying text.
- Text Message Transmission - Transmits text, files, URL cards, and quoted responses to specific chats using remote requests.
- WeChat Automation Tools - Provides programmable tools for managing account settings and automating interactions for personal WeChat profiles.
- WeChat Message Processing - Automates the processing of WeChat communications, including extracting timestamps and downloading profile images.
- Windows Desktop Automation - Acts as a programmatic interface that wraps the Windows application to automate its user interface.
- Background Window Automations - Executes interface actions in the background without requiring the application window to be in focus.
- Event-Driven Callbacks - Executes user-defined functions automatically when the automation engine detects new incoming messages.
- Chat Message Retrieval - Fetches current window messages, historical records, or new incoming messages from the messaging client.
- UI State Polling - Polls the application interface at regular intervals to detect new incoming messages or state changes.
- UI Automation - Simulates user interface interactions to manage contacts and chat sessions within the desktop application.
- Coordinate-Based Interactions - Interacts with interface components using precise pixel offsets and window coordinate mapping.
- Application Launch and Window Managers - Tracks and switches between active application views to ensure correct interface context for automation.
- Agent Skill Integrations - Integrates external bot skills and automated responses into the messaging client.
- OCR-Based Extraction - Converts image-based message content into machine-readable text using optical character recognition.
- Chat - Establishes new group conversations by specifying a list of existing contacts.
- Social Feed Interactions - Allows adding text-based replies to specific entries in the user's social feed.
- Social Interactions - Provides a combined capability to retrieve feed information and perform engagement actions like liking and commenting.
- Social Feed Scrapers - Retrieves social feed content by simulating scrolling through the interface at adjustable speeds.
- WeChat Media Asset Downloaders - Saves images, videos, and files from messages or quoted content to a local folder.
- Social Media Posting - Enables publishing text and multimedia updates directly to the user's social feed.
- Group Chat Administration - Controls group names, announcements, and member nicknames while inviting new participants.
- UI Automation Bridges - Provides a web server that translates HTTP requests into local UI automation sequences for remote control.
- History Retrieval - Fetches a specified number of past messages by scrolling through the conversation history.
- Messaging File Transfers - Provides the ability to send individual files, images, or directories to contacts within the messaging client.
- Message Forwarding Utilities - Sends a selected message to one or more recipients with an optional comment.
- Remote Command Interfaces - Exposes a web interface that allows remote triggering of local messaging actions via network requests.
- Chat Group Member Management - Programmatically adds one or multiple members to a group chat.
- Social Feed Architectures - Provides programmatic control to toggle likes on social feed entries.
- Social Feed Displays - Automates the process of opening and accessing the moments window for social timeline interaction.
- Application Window Navigation - Activates a specific chat window by searching for a contact name.
- Contextual Message Quoting - Quotes a specific message and sends a response with optional text and user mentions.
