Official Introduction (as of 20260105)
EchoTrace is a fully local tool for exporting, analyzing, and generating annual reports from WeChat chat records. It can decrypt your WeChat chat history and save it locally for offline viewing, export it to formats like HTML to share with friends, and generate unique analytical reports based on your conversations 
If you’d like to deeply analyze your chat content after exporting, try ChatLab
Quick Start
For a beginner-friendly tutorial, see this document.
Why EchoTrace Was Created
I wanted to know who time has brought into my life over the years, and what memories have remained.
In the generated reports, I saw how effortlessly I had exchanged tens of thousands of messages with a friend, late-night heart-to-hearts, silent companionship behind tens of thousands of messages—how time quietly brought some people into my life, and gently moved others away.
We’re always moving forward, but rarely get the chance to look back.
If this small report helps you remember a long-uncontacted friend, feel gratitude for those currently by your side, or simply brings a smile and warmth on an ordinary afternoon, then it has served its purpose.
For Developers
If you want to build from source or contribute code, follow these steps:
# 1. Clone the project locally
git clone https://github.com/ycccccccy/echotrace.git
cd echotrace
# 2. Install project dependencies
flutter pub get
# 3. Run the app (debug mode)
flutter run
# 4. Build executable (Windows as example)
flutter build windows
For more details on architecture, file responsibilities, debugging, and CLI usage, please read the Developer Guide.
For implementation details on real-time mode, refer to the Module Invocation Documentation.
Future Plans
We’re working hard to make EchoTrace even better. Planned features include:
Richer message support: Parse and display voice messages, images, and stickers- More visualizations: Add more fun statistics, such as “Annual Word Cloud”, “Sticker Battles”, etc.
Dual-person Annual Report:
- Basic statistics: The date of first conversation and annual summary
- Message type statistics: Radar chart showing types of messages sent (voice, image, video, file, sticker, text), and total message counts per person
- Chat time distribution: Analyze most active times of day, and heatmap of message activity throughout the year
- Word cloud statistics: Show most frequently used words between two people
- Annual report summary: Generate a concise image summarizing the year’s conversations
Have any ideas? Let us know via Issues!
Acknowledgments & Licensing
This project is licensed under the MIT License – you are free to use, modify, and distribute it, but do so at your own risk.
We gratefully acknowledge the following open-source projects that inspired and informed our development:
- chatlog: Thanks for providing key insights and references for decrypting WeChat chat logs
- WxDatDecrypt: Thanks for the reference on decrypting WeChat images
- @sai595870682: Thanks for sharing insights on parsing inline images and voice messages
Final Words
Perhaps while generating your report, you’ll remember a long-lost friend. Maybe you’ll realize someone has been quietly by your side all along. Or maybe you’ll just smile, reflecting on how fast time flies.
Regardless, we hope this little tool becomes a warm witness to your life.
And if it truly touches you, consider sharing it with someone who matters to you.
As long as friends remain, and we still remember each other,
Someday, we will meet again.
Star History
Please use this tool responsibly and comply with applicable laws and regulations.
Perhaps more important than reminiscing about the past is cherishing the people in your life today.