✨ CurateX

Take Control of Your X.com Feed

Hide ads • Filter videos • Block articles • Zero data collection

---

🎮 Try the Interactive Demo

Experience CurateX in action — no installation required!

---

⚡ Features

Feature	Description
🛡️ Ad Blocker	Automatically detects and hides "Promoted" tweets
🎥 Video Filter	Hide videos and GIFs for a text-first experience
📰 Article Filter	Removes external link cards and articles
⚡ High Performance	Dual-layer filtering prevents scroll jumping
🔒 Privacy First	100% local processing — zero data collection

---

🔧 How It Works

CurateX uses a sophisticated hybrid filtering approach:

1. API Interception — Intercepts X's API responses and sanitizes unwanted tweets before they render
2. DOM Observer — Catches any posts that slip through for a 100% clean feed

graph TD
    A[X.com API Response] -->|JSON| B(CurateX Interceptor);
    B --> C{Checks User Settings};
    C -- "Match Found (Ad/Video)" --> D[Sanitize Data];
    D -->|Replace Content| E[Mark as 'Ghost'];
    C -- No Match --> F[Keep Original];
    E --> G[Browser Renderer];
    F --> G;
    G --> H[DOM Content];
    H --> I{Content Script};
    I -->|"Finds 'Ghost'"| J["Hide Visually (0 Opacity, 1px)"];
    I -->|"Missed by API?"| K[Fallback DOM Analysis];
    K -- Match --> L["Hide (display: none)"];

Loading

---

📦 Installation

Chrome Web Store (Recommended)

Install CurateX from the Chrome Web Store — Get automatic updates and the easiest installation experience!

Manual Installation (Developers)

1. Clone this repository or download the source code
2. Open Chrome → chrome://extensions/
3. Enable Developer mode (top right)
4. Click Load unpacked
5. Select the CurateX folder
6. Visit X.com and open the extension popup to configure!

---

🔒 Privacy

CurateX is privacy-first:

• ✅ All processing happens locally on your device
• ✅ No data is collected, stored, or transmitted
• ✅ No analytics or tracking
• ✅ Open source — verify it yourself!

📄 Read our full Privacy Policy

---

📜 Changelog

Stay up to date with the latest changes and improvements. See the CHANGELOG.md for full release notes.

---

📄 License

This project is open source under the MIT License.

---

Made with ❤️ for a cleaner X experience

This extension is for educational and personal customization purposes.