whatisgithub

What is twitter-unfollower?

wesbos/twitter-unfollower — explained in plain English

Analysis updated 2026-07-27 · repo last pushed 2022-12-10

205JavaScriptAudience · developerComplexity · 2/5DormantSetup · moderate

In one sentence

A JavaScript tool that automatically unfollows inactive or stale Twitter accounts based on a threshold you set, cleaning up your feed without manual clicking. Requires Twitter developer API keys to run.

Mindmap

mindmap
  root((repo))
    What it does
      Unfollows stale accounts
      Sets inactivity threshold
      Runs with one command
    Requirements
      Twitter developer account
      API keys and config
      Rate limit workaround
    Use cases
      Clean up old feed
      Prune brand accounts
      Mass unfollow inactive
    Tech stack
      JavaScript
      Twitter API
    Audience
      Power users
      Social media managers
    Limitations
      Rate limiting at 3000
      Needs waiting utility
      API access required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up a personal Twitter feed by unfollowing accounts that have been inactive for a set period.

USE CASE 2

Prune a brand or business Twitter account's following list down to active, relevant accounts.

USE CASE 3

Bulk unfollow hundreds or thousands of stale accounts without manually clicking each one.

USE CASE 4

Automate Twitter feed maintenance on a recurring basis by scheduling the script to run periodically.

What is it built with?

JavaScriptTwitter API

How does it compare?

wesbos/twitter-unfolloweratom/snippetsleonxlnx/lumenshaders
Stars205207203
LanguageJavaScriptJavaScriptJavaScript
Last pushed2022-12-102023-03-15
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity2/51/51/5
Audiencedeveloperdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Twitter developer account with API keys, which now involves an application process that is harder to get approved than it used to be.

No license information is provided in the repository, so usage rights are unclear.

So what is it?

If you've been on Twitter long enough, your following list probably accumulates accounts that have gone quiet, become inactive, or just don't post anything you care about anymore. This tool, created by Wes Bos, automatically unfollows those stale accounts so your feed stays relevant without you having to manually review and unfollow hundreds or thousands of people one at a time. To use it, you need a Twitter developer account and the API keys that come with it. The README notes that getting these keys is harder than it used to be, Twitter cracked down and now requires an application process rather than just handing them out. Once you have the keys, you plug them into a configuration file, set a threshold for what counts as "stale," and run a single command. The script then goes through everyone you follow and removes the ones that don't meet your criteria. There's a practical catch: Twitter limits how many actions you can take in a short window. If you follow more than about 3,000 people, you'll hit their rate limiting. The README suggests a workaround involving a separate waiting utility that pauses the script for a minute between batches, letting you process large following lists without getting blocked. This is really a utility for power users, people who follow thousands of accounts and want to clean house without spending an afternoon clicking unfollow. A social media manager pruning an old brand account, or just someone who's been on Twitter since the early days and wants to reset their feed, would find this useful. It's a straightforward tool: it does one job, requires some technical comfort to set up, and depends on Twitter's developer access staying available.

Copy-paste prompts

Prompt 1
I have a Twitter developer account with API keys. Help me set up the wesbos/twitter-unfollower tool, what configuration file do I need to create, what fields go in it, and what command do I run to start unfollowing stale accounts?
Prompt 2
I follow over 5000 people on Twitter and want to use the twitter-unfollower script without hitting rate limits. Walk me through setting up the waiting utility that pauses the script between batches of unfollows.
Prompt 3
I want to unfollow Twitter accounts that haven't tweeted in over 6 months. How do I configure the staleness threshold in the twitter-unfollower tool, and what does the script actually check to determine if an account is stale?
Prompt 4
Help me understand the twitter-unollower tool's workflow: after I plug in my API keys and set my threshold, what exactly does the script do step by step when I run it?

Frequently asked questions

What is twitter-unfollower?

A JavaScript tool that automatically unfollows inactive or stale Twitter accounts based on a threshold you set, cleaning up your feed without manual clicking. Requires Twitter developer API keys to run.

What language is twitter-unfollower written in?

Mainly JavaScript. The stack also includes JavaScript, Twitter API.

Is twitter-unfollower actively maintained?

Dormant — no commits in 2+ years (last push 2022-12-10).

What license does twitter-unfollower use?

No license information is provided in the repository, so usage rights are unclear.

How hard is twitter-unfollower to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is twitter-unfollower for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.