Browser extension to semi-automatically identify and block fake followers or bots on X (formerly Twitter).
Chrome, brave, edge and other chromium-based browsers can install the extension directly from the Chrome Web Store:
You may wish to install the extension manually if you want to use a specific version or if you are a developer. Follow these steps:
- Download the latest release for your preferred browser.
- Unzip the downloaded file.
- Open your browser and navigate to
chrome://extensions. - Enable the "Developer mode" toggle in the top right corner.
- Click the "Load unpacked" button and select the unzipped folder.
The extension should now be installed and ready to use. Pin it to your browser toolbar for easy access.
See my article on dev.to for a detailed guide with screenshots on how to use this extension.
In short, follow these steps:
- Install the extension and pin it to your browser toolbar for easy access.
- After installing the extension for the first time, navigate to https://x.com/home at least once. This step is crucial for the extension to initialize itself. You will gracefully receive an error message if you forget this step.
- Open the extension and click 'scan' to analyze your followers list for unwanted accounts.
- Select the accounts you want to get rid of and then click the 'block' button at the top.
- Go grab a drink while the extension blocks all of the accounts you selected. This action can take a while depending on the amount of followers your selected and the configured timeout in the extension settings.
You can fully customize the extension to your needs by right clicking the extension icon in Chrome (or click the 3-dots menu icon if you didn't pin the extension yet) and selecting 'Options'.
Can I get in trouble for using this extension?
No, this extension is designed to help you block fake followers and bots on X. At the time of writing, it does not violate X's TOS. However, it is important to note that the extension is not perfect and may block real users by mistake. Misconfiguration of the timeout settings may also result in temporary rate limits imposed on your account. Use this extension at your own discretion.
Do you support [browser name]?
Currently, only Chromium-based browsers (i.e. Chrome, Edge, Brave etc.) are supported. However, we are working on adding support for other browsers in the future. See the project issues tab to keep track of progress.
I followed the instructions but keep gettting the 'missing headers' error.
Log out from X and sign in again to fix this issue.
Skip this section if you are not interested in contributing to this project.
This is a Plasmo extension project bootstrapped with plasmo init.
At the time of writing, Node.js v20 is required to run this project without weird build issues. Please install nvm to make managing Node versions easier and then run nvm use at the root of this project to switch to the supported version. We also strongly recommend you to use pnpm as your package manager, as it is the one we use to develop and test this project and npm has caused issues with Plasmo in the past.
Then, make sure your have the dependencies installed:
$ pnpm installFinally, start the development server:
$ pnpm devOpen your browser and load the appropriate development build. For example, if you are developing for the chrome browser, using manifest v3, use: build/chrome-mv3-dev.
You can start editing the popup by modifying popup.tsx. It should auto-update as you make changes. To change the options page, simply change the options.tsx.
For further guidance, visit the Plasmo Documentation
Run the following:
$ pnpm buildThis should create a production bundle for the extension, ready to be zipped and published to the stores.
The easiest way to deploy the Plasmo extension is to use the built-in bpp GitHub action. Prior to using this action however, make sure to build your extension and upload the first version to the store to establish the basic credentials. Then, simply follow this setup instruction and you should be on your way for automated submission!
This project is licensed under the GNU General Public License v3.0.