Unfollow Management

Browser console scripts for managing who you follow on X/Twitter. All scripts run in DevTools console.

Script Selection

How Each Script Works

unfollowEveryone.js

Bulk unfollows every account you follow. Processes in batches with scroll-and-click cycles.

Algorithm: Find all [data-testid$="-unfollow"] buttons → click each → confirm in dialog → scroll down for more → repeat. Includes retry logic (3 attempts when no buttons found), progress tracking with ETA, sessionStorage persistence across page refreshes, auto JSON export of unfollowed accounts.

Controls:

• window.XActions.pause() — Pause execution
• window.XActions.resume() — Resume
• window.XActions.abort() — Stop and export results

unfollowback.js

Unfollows accounts that don't follow you back (non-mutual). Identifies non-followers by checking for the absence of the "Follows you" badge.

Algorithm: For each user cell, check if [data-testid="userFollowIndicator"] exists. If NOT present → unfollow. Processes one-by-one with configurable delay.

Output: Console log of each unfollowed account, running count, final JSON export.

unfollowWDFBLog.js

Same non-follower detection as unfollowback.js but collects usernames and auto-downloads a .txt log file when complete. Useful for record-keeping before mass unfollowing.

Output: Downloaded unfollowed-nonfollowers-TIMESTAMP.txt file + console summary.

smartUnfollow.js (Automation)

Requires: Paste src/automation/core.js first.

Uses follow timestamps from keywordFollow.js to only unfollow users who haven't followed you back within a configurable grace period. Supports a whitelist to protect VIP accounts.

Config:

• gracePeriodDays: 7 — Days to wait before unfollowing
• whitelist: ['account1', 'account2'] — Protected accounts

followRatioManager.js

Monitors and manages your follower/following ratio with actionable improvement plans.

Features:

• Letter-grade rating (S through F)
• Visual ratio bar
• Three improvement paths: unfollow accounts, gain followers, or combination
• Weekly growth projections
• localStorage history with trend tracking
• Cross-references other XActions scripts in recommendations

Controls:

• XActions.setTarget(ratio) — Set goal ratio (e.g., 2.0)
• XActions.track() — Record current snapshot
• XActions.history() — View trend over time
• XActions.plan() — Generate actionable plan

detectUnfollowers.js

Takes snapshots of your follower list and compares to detect who unfollowed you.

Navigate to: x.com/USERNAME/followers

removeFollowers.js

Removes followers from YOUR list using the block-then-unblock method.

Navigate to: x.com/USERNAME/followers

DOM Selectors

Rate Limiting & Safety

• Default delay: 1–2 seconds between unfollows (gaussian randomized)
• Batch delay: 2–3 seconds between scroll batches
• Rate limit detection: Scripts check for [data-testid="toast"] warning banners
• Backoff: If rate limited, scripts wait 30–60 seconds before retrying
• Daily limit guidance: X may restrict after ~400 unfollows/day; spread over multiple sessions
• Recovery: If action-restricted, wait 12–24 hours

Strategy Guide

Cleaning a bloated following list

1. Run src/followRatioManager.js on your profile to assess current ratio
2. Use XActions.plan() to see how many unfollows are needed
3. Run src/unfollowback.js to remove non-followers first (safest)
4. If more cleanup needed, use src/unfollowEveryone.js with abort when satisfied
5. Re-check ratio with XActions.track()

Maintaining a healthy ratio over time

1. Set up periodic runs of src/detectUnfollowers.js to track losses
2. Use src/followRatioManager.js weekly to monitor trends
3. Run src/unfollowback.js monthly to remove non-reciprocal follows
4. Keep a whitelist in smartUnfollow.js for accounts you always want to follow

Before a big unfollow session

1. Export your following list first: scripts/scrapeFollowing.js
2. Run src/unfollowWDFBLog.js (saves log of who was unfollowed)
3. Review the downloaded log for any mistakes
4. Use src/followRatioManager.js to verify improvements

Troubleshooting

Related Skills

• follower-monitoring — Track follower growth and detect unfollowers
• blocking-muting-management — Block/unblock for removing followers
• growth-automation — Grow followers to improve ratio organically
• analytics-insights — Understand engagement before unfollowing