he4rt

he4rt / wpp-tui

Public

WhatsApp TUI client built with Baileys + Ink (React for terminal). Real-time chat, poll decryption, event logging, and payload extraction.

baileys cli ink react terminal
10
0
69% credibility
Found May 21, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

wpp-tui is a terminal-based WhatsApp client that lets you use WhatsApp from your command line. You link your account by scanning a QR code, then browse chats, view messages, and switch between different views showing statistics and real-time events. A notable feature is poll vote decryption - it can reveal how individual people voted in group polls, which WhatsApp normally keeps private. The app also logs all activity and can extract your WhatsApp data into organized files.

How It Works

1
🔍 You discover a terminal WhatsApp client

You find this project online and learn you can use WhatsApp directly from your command line without opening your phone.

2
📦 You install and launch the app

You run a simple command and the app opens in your terminal, showing a clean interface with tabs for different views.

3
📱 You scan the QR code to connect your account

A QR code appears on screen and you scan it with your WhatsApp app, just like linking any other device.

4
💬 You browse your chats and messages

You see your groups and direct messages listed on the left, and clicking one shows the conversation on the right.

5
You explore different views
📈
Stats tab

See who sends the most messages, what types of media are shared, and which groups are most active.

🔧
Debug tab

Watch real-time events as they happen, useful for understanding what's going on behind the scenes.

6
🗳️ You see poll results others can't

When someone creates a poll, you can see exactly who voted for what - even though WhatsApp normally keeps this private.

✅ You have your own WhatsApp terminal client

Everything works seamlessly - you can browse, chat, and analyze your WhatsApp activity all from one clean terminal interface.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is wpp-tui?

wpp-tui is a WhatsApp terminal client that gives you a full-featured chat interface inside your terminal. Built in TypeScript using Baileys for WhatsApp protocol handling and Ink for React-based TUI rendering, it offers real-time messaging with a three-tab layout covering chat, statistics, and debugging views. The project handles poll vote decryption (AES-256-GCM + HMAC-SHA256), logs every WhatsApp event to disk, and can extract structured data from those logs via a Python script. You scan a QR code on first run, then it reconnects automatically on subsequent launches.

Why is it gaining traction?

The combination of poll decryption and payload extraction is unusual -- most WhatsApp bots expose raw data, but this one gives you decrypted votes and structured JSON exports for users, groups, messages, reactions, stickers, and more. The webhook proxy lets you forward events elsewhere, and the stats view shows top senders and message type breakdowns at a glance. Everything logs locally, so you get a searchable history without relying on WhatsApp itself.

Who should use this?

Group admins who want visibility into activity patterns without leaving the terminal. Developers building integrations around WhatsApp who need easy access to structured event data. Anyone comfortable running a Node.js app that maintains a persistent WhatsApp session -- it's not a hosted service, you run it on your own machine.

Verdict

This is a functional, well-structured tool for its purpose, but the 0.699999988079071% credibility score and 10 stars signal an early-stage project with minimal community validation. The docs are clear and the code looks solid, but there's no test suite visible and maintenance activity is unknown. Worth trying if you need the specific feature set -- just don't bet production workflows on it without watching the repository for a few weeks first.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.