Wawa

About

**Take Control of Your Twitter/X Data**

Wawa is a privacy-focused Chrome extension that lets you export your complete X/Twitter history to your own computer—no cloud uploads, no third-party servers, no tracking. Your data stays yours.

🔒 **100% Local & Private**
• All processing happens in your browser
• No data sent to external servers
• No analytics, no telemetry, no tracking
• Open source and auditable: https://github.com/ragaeeb/wawa

📊 **Complete Exports (Not Just 3,200 Tweets)**
• Captures replies that official APIs miss
• Exports threads and conversations
• Includes all engagement metrics
• Uses the same data Twitter's own web UI shows

⏸️ **Pause & Resume for Large Accounts**
• Export 10,000+ tweets without time pressure
• Resume exactly where you left off
• Automatic checkpoint saving every 1,000 tweets
• Handles rate limits intelligently

💾 **Smart Storage Management**
• Chunked storage for 100MB+ exports
• Automatic cleanup after completion
• IndexedDB primary + chrome.storage fallback
• No quota worries for large accounts

**How It Works**

1. **Install** the extension from Chrome Web Store
2. **Navigate** to any X/Twitter profile (including your own)
3. **Click** the "📜 Export Tweets" button that appears
4. **Wait** for collection (or pause and resume later)
5. **Download** your data as a clean JSON file

**What Gets Exported**

Your export includes:
• Tweet text and timestamps
• Author information (username, display name, verified status)
• Engagement counts (likes, retweets, replies, views)
• Media URLs (images, videos, links)
• Conversation threads
• Quote tweets and retweets

**Why Wawa vs. Official Archive?**

| Feature | Wawa | Twitter Archive Request |
|---------|------|-------------------------|
| Speed | Minutes | 24-48 hours |
| Frequency | Unlimited | Once/week |
| Format | Clean JSON | Complex ZIP |
| Replies | ✅ Complete | ⚠️ Limited |
| Resume | ✅ Yes | ❌ No |
| Privacy | 100% Local | Uploaded to Twitter servers |

**Technical Features**

• **Zero Dependencies**: No external libraries or trackers
• **Manifest V3**: Future-proof Chrome extension architecture
• **TypeScript**: Type-safe, maintainable codebase
• **80%+ Test Coverage**: Thoroughly tested core logic
• **Open Source**: MIT licensed, community-driven

**Privacy Commitment**

We take your privacy seriously:

✅ **No Data Collection**: We don't see, store, or transmit your data
✅ **No Analytics**: No usage tracking or telemetry
✅ **No Remote Code**: All code bundled with extension
✅ **No Third Parties**: No external services or APIs called
✅ **Transparent**: Fully open source for auditing

Read our full Privacy Policy: https://github.com/ragaeeb/wawa/blob/main/PRIVACY_POLICY.md

**Use Cases**

• **Personal Archive**: Back up your tweet history before deactivation
• **Research**: Analyze your posting patterns and engagement
• **Migration**: Move your data to other platforms
• **Content Creators**: Archive your threads and viral tweets
• **Compliance**: Retain records for professional/legal purposes
• **Deletion Planning**: Review what you've posted before bulk deletion

**Rate Limit Friendly**

Wawa respects Twitter's API limits:
• Monitors rate limit headers in real-time
• Auto-pauses when limits approached
• Shows countdown to limit reset
• Resume with one click when ready

**System Requirements**

• Chrome, Edge, Brave, or any Chromium-based browser
• Minimum version: Chrome 88+ (Manifest V3 support)
• Works on: Windows, macOS, Linux, Chrome OS

**Support & Development**

• **Report Issues**: https://github.com/ragaeeb/wawa/issues
• **Request Features**: GitHub Discussions
• **Source Code**: https://github.com/ragaeeb/wawa
• **License**: MIT (free and open source)

**Developer**: Ragaeeb Haq (https://github.com/ragaeeb)

**Disclaimer**

Wawa is not affiliated with X Corp or Twitter, Inc. This is an independent tool built for data portability and user privacy. By using this extension, you agree to comply with X/Twitter's Terms of Service.

---

**Made with ❤️ for privacy-conscious users who believe data should belong to its creator.**