𝕏 Unlike All

A fully local, safe, and robust tool to unlike all your likes on X (Twitter). No external APIs, no browser extensions, no third-party services. Just your machine and Playwright.

Features

• 100% Local: Your credentials and data never leave your machine.
• Persistent Context: Reuses your real Chrome profile (no login needed every time).
• Human-like Pacing: Randomized delays to avoid account flags.
• Dry-run Mode: Test without making any actual changes.
• State Persistence: Keeps track of your progress across sessions.
• Rate-limit Aware: Automatically detects and pauses on rate-limit toasts.

---

Setup Instructions

1. Prerequisites

• Node.js ≥ 20
• A desktop environment (for the first login)

2. Installation

git clone https://github.com/berktugates/x-unlike-all.git
cd x-unlike-all
npm install

3. Configuration

Copy .env.example to .env and fill in your details:

cp .env.example .env

Key Configs:

• X_USERNAME: Your X handle.
• DRY_RUN: Set to true first to see what would happen.
• HEADLESS: Set to false (recommended) to see the action.

---

How to Use

First Run (Manual Login)

1. Set HEADLESS=false in .env.
2. Run the tool: npm start.
3. If not logged in, log in to X manually in the opened browser window.
4. Close the browser once logged in.
5. The tool will automatically detect the session in future runs.

Full Cleanup

Once you are confident, set DRY_RUN=false and MAX_TOTAL_ACTIONS=5000 (or whatever your limit is) and let it run.

---

Important Considerations

• Rate Limits: X has strict rate limits on unliking. If the tool detects a "Retry again" message, it will pause for 5 minutes.
• ToS: Automating interactions may violate X's Terms of Service. Use this at your own risk.
• Staff Engineer Tip: If you have thousands of likes, run this in small batches (e.g., 500 actions at a time).