X Mass Blocker

A Chrome extension for bulk-blocking (and bulk-unblocking) accounts on X / Twitter, with a searchable dashboard, safety checks, and bilingual (English/Persian) support.

Choose your language / زبان خود را انتخاب کنید: English | فارسی

📸 Want a screenshot-by-screenshot walkthrough (including Android)? See the Visual Guide.

📸 دنبال یه آموزش قدم‌به‌قدم و تصویری هستی (شامل اندروید)؟ برو سراغ راهنمای تصویری.

---

English

What is this?

X Mass Blocker lets you block (or unblock) many X/Twitter accounts at once, instead of doing it one by one from each profile page. You paste a list of usernames or numeric X IDs, and the extension works through the list in the background while you keep browsing.

It has two ways to open it, and a full dashboard with several tabs.

Two ways to open the extension

1. Toolbar icon → quick popup Click the extension's icon in the browser toolbar (top-right of Chrome). A small popup box opens right there — a fast way to paste a list and hit start without leaving your page.

2. Icon on the X page → full dashboard tab While browsing x.com or twitter.com, a small round icon appears floating on the right edge of the page. Clicking it opens the full dashboard in a new tab, with every feature (Preview, Bulk Unblock, ID Finder, Blocked Accounts list, Settings).

Use the popup for quick, simple jobs. Use the full dashboard tab when you want the extra tools below.

Dashboard tabs

• Mass Block — paste a list (one username or X ID per line), choose whether the list is usernames or numeric X IDs, set a delay between each block, and hit start. A Preview button lets you see counts (already blocked / known contacts / will actually be blocked) before anything happens.
• Bulk Unblock — the same idea in reverse: paste a list and unblock everyone on it in one go, without needing to fetch your whole blocked list first.
• ID Finder — type a username, get back its numeric X ID (with a one-click copy button).
• Blocked Accounts — fetches your full list of currently blocked accounts (name, username, numeric ID, bio), with live search, sortable columns, checkbox selection, bulk unblock straight from the table, and CSV export.
• Settings — light/dark theme, what to do if a job is interrupted by a page refresh (ask / resume automatically / never resume), a warning before blocking someone you follow or who follows you, desktop notification when a job finishes, and a whitelist of accounts that should never be blocked.

The whole interface — both the popup and the full dashboard, in both languages — uses the Vazirmatn typeface, bundled locally rather than loaded from an external source. Vazirmatn is the legacy of its late creator, Saber Rastikerdar; there's a short note of thanks to him in the Settings tab.

Safety features

• Preview before starting — see how many entries are valid, already blocked, or known contacts, with nothing actually blocked yet.
• Follow-relationship warning — before blocking, the extension checks if any account on your list follows you or is followed by you, and asks you to confirm (per-account) before blocking them.
• Whitelist — accounts you add here are silently skipped, no matter what list you paste.
• Resume after refresh — if you refresh the X tab mid-operation, the extension picks up where it left off (or asks you first, depending on your Settings).
• Final report — a summary panel on the X page shows totals: blocked, skipped, whitelisted, failed.

Installation (unpacked / developer mode)

1. Download and unzip this extension.
2. Open chrome://extensions in Chrome.
3. Turn on Developer mode (top-right toggle).
4. Click Load unpacked and select the unzipped folder.
5. Pin the extension icon to your toolbar for quick access.

Permissions used

• storage — to save your lists, settings, and language/theme choice locally.
• scripting / activeTab / tabs — to run the block/unblock/search logic on the active X tab.
• notifications — to show a desktop notification when a job finishes (optional, toggle in Settings).
• Host permissions for x.com and twitter.com only — the extension does not run on any other site.

Important notes

• This extension calls X's own internal web APIs (the same ones your browser uses when you use X normally) using your existing logged-in session. It does not use any official, documented X API and does not require an API key.
• These internal endpoints are undocumented and can change or be rate-limited by X at any time without notice. If something stops working, it's usually because X changed something on their end.
• Use reasonable delays between actions and reasonable list sizes to avoid tripping X's own rate limits.
• This is provided as-is, for personal use. You are responsible for complying with X's Terms of Service.

License

MIT — Free to use, modify, and distribute with attribution

---

فارسی

این افزونه چیه؟

افزونه X Mass Blocker یک ابزار مرورگر است که به شما اجازه می‌دهد به جای مراجعه تک‌تک به پروفایل‌ها، یک لیست از یوزرنیم‌ها یا آیدی‌های عددی (X ID) را وارد کرده و همه را به صورت دسته‌جمعی بلاک (یا آنبلاک) کنید. این افزونه در پس‌زمینه کار خود را انجام می‌دهد و شما می‌توانید به مرور عادی خود در توییتر ادامه دهید.

دو روش برای باز کردن افزونه وجود دارد و یک داشبورد کامل با چند تب مختلف در اختیار شماست.

دو راه برای باز کردن افزونه

۱. آیکون نوار ابزار مرورگر ← باکس کوچک (Popup) روی آیکون افزونه در نوار ابزار بالای مرورگر کلیک کنید. یک باکس کوچک باز می‌شود که برای کارهای سریع و ساده مناسب است؛ می‌توانید لیست را جای‌گذاری کرده و بدون خروج از صفحه فعلی، عملیات را شروع کنید.

۲. آیکون داخل صفحه توییتر ← تب کامل داشبورد هنگام مرور صفحات x.com یا twitter.com، یک آیکون شناور در سمت راست صفحه ظاهر می‌شود. با کلیک روی آن، داشبورد کامل در یک تب جدید باز می‌شود و تمامی امکانات (پیش‌نمایش، آنبلاک دسته‌جمعی، دریافت آیدی، لیست بلاک‌شده‌ها و تنظیمات) در دسترس شما قرار می‌گیرد.

نکته: برای کارهای سریع از پاپ‌آپ و برای دسترسی به ابزارهای پیشرفته‌تر از تب کامل داشبورد استفاده کنید.

تب‌های داشبورد

• بلاک دسته‌جمعی (Mass Block) — یک لیست وارد کنید (هر یوزرنیم یا X ID در یک خط)، نوع لیست را مشخص کنید، تاخیر بین هر بلاک را تنظیم کرده و شروع کنید. دکمه پیش‌نمایش قبل از انجام هر کاری، آمار حساب‌های از قبل بلاک‌شده، آشنایان و مواردی که بلاک خواهند شد را نشان می‌دهد.
• آنبلاک دسته‌جمعی (Bulk Unblock) — همانند بخش قبل، می‌توانید یک لیست وارد کرده و همه را یک‌جا آنبلاک کنید بدون اینکه نیاز باشد ابتدا لیست کامل بلاکی‌ها را دریافت کنید.
• دریافت آیدی از یوزرنیم (ID Finder) — با وارد کردن یوزرنیم، آیدی عددی (X ID) آن را همراه با دکمه کپی سریع دریافت کنید.
• لیست بلاک‌شده‌ها (Blocked Accounts) — دریافت کامل لیست حساب‌های بلاک‌شده (نام، یوزرنیم، آیدی عددی، بیو) همراه با جستجوی زنده، مرتب‌سازی ستون‌ها، انتخاب با چک‌باکس، آنبلاک گروهی و خروجی CSV.
• تنظیمات (Settings) — تغییر تم (روشن/تیره)، تعیین رفتار هنگام رفرش صفحه (پرسش / ادامه خودکار / عدم ادامه)، هشدار هنگام بلاک کردن دنبال‌کنندگان یا دنبال‌شوندگان، اعلان دسکتاپ پس از اتمام کار، و لیست استثناها (Whitelist).

ویژگی‌های ایمنی

• پیش‌نمایش قبل از شروع — مشاهده تعداد ورودی‌های معتبر، حساب‌های از قبل بلاک‌شده و آشنایان، قبل از اعمال هرگونه تغییر.
• هشدار روابط دنبال‌کردن — بررسی حساب‌ها قبل از بلاک شدن؛ اگر حسابی شما را دنبال کرده یا شما آن را دنبال می‌کنید، افزونه قبل از بلاک کردن از شما تایید می‌گیرد.
• لیست استثناها (Whitelist) — حساب‌های موجود در این لیست تحت هیچ شرایطی بلاک نخواهند شد.
• ازسرگیری بعد از رفرش — در صورت رفرش شدن تب توییتر وسط عملیات، افزونه کار را از همان نقطه ادامه می‌دهد (بر اساس تنظیمات شما).
• گزارش نهایی — نمایش خلاصه عملکرد شامل تعداد موارد بلاک‌شده، ردشده، موجود در لیست استثنا و ناموفق.

نصب (حالت Unpacked / Developer mode)

1. فایل افزونه را دانلود کرده و از حالت فشرده (zip) خارج کنید.
2. در مرورگر کروم به آدرس chrome://extensions بروید.
3. گزینه‌ی Developer mode در بالا سمت راست را فعال کنید.
4. روی دکمه Load unpacked کلیک کرده و پوشه استخراج‌شده را انتخاب کنید.
5. آیکون افزونه را به نوار ابزار پین کنید تا دسترسی سریع‌تری داشته باشید.

دسترسی‌های مورد استفاده

• storage — جهت ذخیره محلی لیست‌ها، تنظیمات، زبان و تم انتخاب‌شده.
• scripting / activeTab / tabs — جهت اجرای منطق بلاک، آنبلاک و جستجو روی تب فعال توییتر.
• notifications — جهت نمایش اعلان دسکتاپ پس از اتمام کار (اختیاری و قابل غیرفعال‌سازی از تنظیمات).
• دسترسی‌های دامنه — فقط برای x.com و twitter.com (افزونه روی هیچ سایت دیگری اجرا نمی‌شود).

نکات مهم

• این افزونه از APIهای داخلی وب توییتر (همان مواردی که مرورگر هنگام استفاده عادی استفاده می‌کند) با استفاده از نشست فعال شما استفاده می‌کند. این ابزار به هیچ API رسمی نیازی ندارد و نیازی به API Key ندارد.
• این مسیرهای داخلی بدون مستندات رسمی هستند و ممکن است هر زمان توسط توییتر تغییر کرده یا محدود (Rate Limit) شوند. در صورت بروز مشکل، معمولاً علت آن تغییرات سمت توییتر است.
• برای جلوگیری از محدودیت‌های توییتر، از تاخیرهای معقول و لیست‌هایی با حجم مناسب استفاده کنید.
• این افزونه به صورت As-Is برای استفاده شخصی ارائه شده است و مسئولیت رعایت قوانین و مقررات توییتر (Terms of Service) بر عهده کاربر است.

مجوز (License)

مجوز MIT — استفاده، تغییر و توزیع با ذکر منبع آزاد است.