🌍 X-Posed

See where X users are really posting from.
Country flags, device info, VPN detection, and powerful filtering — all in one extension.

---

✨ Key Features

🏳️ Country Flags & Device Detection

Every tweet shows the author's real location and device at a glance.

Indicator	Meaning
🇺🇸 🇬🇧 🇯🇵	Country flag from X's location data
🍎	iOS (iPhone/iPad)
🤖	Android
🌐	Web browser
🔒	VPN/Proxy detected — location may not be accurate

---

🚫 Location & Tag Blocking

Filter your timeline by hiding or highlighting tweets based on location or display name patterns.

Countries — Block individual countries with one-click selection
Regions — Block entire geographic areas (Europe, South Asia, Africa, etc.)
Tags — Block users with specific emojis, symbols, or text in their display names

Two blocking modes:

• Hide (default) — Blocked tweets vanish from your feed
• Highlight — Blocked tweets stay visible with a subtle amber border

---

📸 Evidence Screenshot

Capture any tweet with a forensic metadata overlay showing location, device, VPN status, and timestamp.

Perfect for researchers, journalists, and OSINT professionals who need to document social media evidence.

---

📊 Statistics Dashboard

See your cached data at a glance:

• 🌍 Top countries — Most common locations in your cache
• 📱 Device breakdown — iOS vs Android vs Web distribution
• 🔒 VPN users — Percentage of users detected with VPN/proxy
• ☁️ Cloud stats — Community cache contribution metrics

---

💾 Export & Import

Full backup and restore of your configuration:

• All settings and preferences
• Blocked countries, regions, and tags
• Cached user data

Move between browsers or share configurations across devices.

---

🚀 Installation

Browser	Link
Chrome / Edge / Brave	Chrome Web Store
Firefox	Firefox Add-ons
iOS / iPadOS	App Store

Manual installation:

git clone https://github.com/xaitax/x-account-location-device.git
cd x-account-location-device/extension
npm install
npm run build

Load dist/chrome or dist/firefox as an unpacked extension.

---

⚙️ Configuration

Quick Settings (Popup) — Click the extension icon for instant toggles:

• ✅ Enable/disable extension
• 🏳️ Show/hide country flags
• 📱 Show/hide device icons
• 🔒 Show/hide VPN indicator
• 👁️ Filter VPN user tweets
• 🗑️ Clear local cache

Full Options Page — Right-click the extension icon → Options:

• Statistics — View cached data analytics
• Cloud Cache — Enable community sharing (opt-in)
• Location Blocking — Manage blocked countries and regions
• Export/Import — Backup and restore configuration

---

☁️ Community Cloud Cache

Optional feature — Share anonymous lookups with other users.

Benefit	Description
⚡ Faster lookups	Instant responses from cached community data
🛡️ Avoid rate limits	Reduce direct API calls to X
👥 Community powered	One user's lookup helps everyone

Privacy: Only username → location/device mappings are shared. No personal data, no IP logging.

Enable in Options → Cloud Cache → Enable Community Cache.

---

🔐 Privacy

Mode	What happens
Default	All data stored locally. API calls go directly to X. No external servers.
With Cloud Cache	Username → location mappings shared anonymously. Self-hostable.

Read the full Privacy Policy.

---

🔧 Development

cd extension
npm run dev:chrome    # Watch mode for Chrome
npm run dev:firefox   # Watch mode for Firefox
npm run build         # Production build
npm run package       # Create distribution zips

Project Structure:

extension/src/
├── background/   # Service worker, API client
├── content/      # DOM observer, badge injection
├── popup/        # Quick settings popup
├── options/      # Full settings page
└── shared/       # Constants, utilities, storage

---

📝 Changelog

v2.5.0 — Latest

✨ New

• Toggle Capture Button — Show/hide the camera button on badges

⚡ Performance

• Faster lookups — 2x faster API with optimized throttling
• Cloud cost savings — Edge caching & deduplication (~80% reduction)

View full changelog →

---

👤 Author

Alexander Hagenah

---

⭐ Star this repo if X-Posed helps you!

X-Posed — Know who you're talking to.