Download the PHP package hejunjie/wechat-bill-parser without Composer
On this page you can find all versions of the php package hejunjie/wechat-bill-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hejunjie/wechat-bill-parser
More information about hejunjie/wechat-bill-parser
Files in hejunjie/wechat-bill-parser
Package wechat-bill-parser
Short Description 一个高性能、自动化的微信账单解析器,支持压缩包密码自动破解与账单数据智能提取,适用于账单分析、账单自动化入账、个人理财工具开发等场景 | A fast, automated Wechat bill parser that cracks compressed file passwords and extracts bill data. Perfect for bill analysis, automatic bookkeeping, and personal finance tools
License MIT
Informations about the package wechat-bill-parser
hejunjie/wechat-bill-parser
English | 简体中文
[!WARNING] This project is for learning and communication purposes only. Commercial or illegal use is strictly prohibited.
A PHP library for automated WeChat bill parsing: cracks ZIP archive passwords and extracts bill data from Excel files. Ideal for personal finance tracking, automated bookkeeping, and financial tool development.
Want a quick overview? The codebase has been parsed by Zread.
Features
- 🔐 Automatic ZIP Password Cracking: Multi-process brute-force tool written in C, delivering fast results with minimal resource usage
- 📦 No Manual Extraction Needed: Handles password-protected archives — automatically decompresses and reads bill data
- 📄 Intelligent Data Extraction: Parses WeChat bill Excel files to extract account nicknames and transaction details
- 🧩 Callback-Driven Flow Control: Use
onPasswordFound/onDataParsedcallbacks to flexibly control the parsing process - 📬 Email Monitoring Ready: Combine with email auto-forwarding for fully automated bill collection and parsing
Requirements
- PHP >= 8.1
- libzip
- gcc (for compiling the password cracker)
- Composer
Install System Dependencies
Ubuntu / Debian:
macOS (Homebrew):
[!NOTE] macOS ships with gcc (actually clang), no extra install needed. Windows users can use this library via WSL.
Installation
On first run, the library automatically compiles the C-based password cracker. Make sure gcc and libzip are properly installed.
Quick Start
Only implement the callbacks you need. For example, if you only care about the password, just set onPasswordFound and leave onDataParsed unset.
Output Structure
The $data array passed to the onDataParsed callback has the following structure:
Project Structure
FAQ
What if password cracking fails?
WeChat bill ZIP passwords are typically 6-digit numbers. The cracker iterates through common password patterns. If cracking fails, make sure the ZIP file is not corrupted and is indeed a WeChat-exported bill file.Does it support Alipay bills?
Alipay bill parsing is available in a separate repository: [php-alipay-bill-parser](https://github.com/zxc7563598/php-alipay-bill-parser).Motivation
I keep track of my personal finances, but the bill formats exported by WeChat and Alipay are inconsistent and often arrive as encrypted ZIP archives. Manually exporting, extracting, and organizing these bills every time was tedious, so I built this tool to:
- Serve as middleware for personal bill processing, eliminating manual download and extraction steps
- Work with email monitoring scripts — forward bill emails to a designated address and parse everything automatically
Contact
Questions or suggestions? Feel free to open a GitHub Issue.