// ==UserScript== // @name Twitter/X Mass Unfollower (Skip Followers) // @namespace tweeks.io // @version 4.0 // @description Mass unfollow tool for Twitter/X - unfollow up to 150 people in 3 batches of 50, skipping users who follow you back. Control panel always visible on the right side. // @author Tweeks // @match https://x.com/*/following // @match https://twitter.com/*/following // @grant GM_registerMenuCommand // ==/UserScript== (function() { 'use strict'; // Configuration let config = { batchSize: 50, delayBetweenUnfollows: 1000, // milliseconds between each unfollow delayBetweenBatches: 30000, // milliseconds between batches (30 seconds default) skipFollowers: true, // skip users who follow you back numBatches: 3 // number of batches to run }; // Load saved config from localStorage function loadConfig() { const saved = localStorage.getItem('massUnfollowConfig'); if (saved) { try { config = { ...config, ...JSON.parse(saved) }; } catch (e) { console.error('Failed to load config:', e); } } } // Save config to localStorage function saveConfig() { localStorage.setItem('massUnfollowConfig', JSON.stringify(config)); } // Load config on startup loadConfig(); // State management let isRunning = false; let unfollowCount = 0; let skippedCount = 0; let totalToUnfollow = 0; let currentBatch = 0; let panelMinimized = false; // Create floating control panel - ALWAYS VISIBLE function createControlPanel() { const panel = document.createElement('div'); panel.id = 'mass-unfollow-panel'; panel.innerHTML = `

⚡ Mass Unfollower

Batch Size (max 50):

Number of Batches:

Delay between unfollows (ms):

Delay between batches (seconds):

Skip users who follow me back

Ready to unfollow

`; document.body.appendChild(panel); // Event listeners document.getElementById('minimize-panel').addEventListener('click', () => { const content = document.getElementById('panel-content'); const btn = document.getElementById('minimize-panel'); panelMinimized = !panelMinimized; if (panelMinimized) { content.style.display = 'none'; btn.textContent = '+'; btn.title = 'Expand panel'; } else { content.style.display = 'block'; btn.textContent = '−'; btn.title = 'Minimize panel'; } }); document.getElementById('batch-size').addEventListener('change', (e) => { config.batchSize = Math.min(50, Math.max(1, parseInt(e.target.value) || 50)); e.target.value = config.batchSize; saveConfig(); }); document.getElementById('num-batches').addEventListener('change', (e) => { config.numBatches = Math.max(1, Math.min(10, parseInt(e.target.value) || 3)); e.target.value = config.numBatches; saveConfig(); }); document.getElementById('delay-unfollow').addEventListener('change', (e) => { config.delayBetweenUnfollows = Math.max(100, parseInt(e.target.value) || 1000); e.target.value = config.delayBetweenUnfollows; saveConfig(); }); document.getElementById('delay-batch').addEventListener('change', (e) => { const seconds = Math.max(5, Math.min(300, parseInt(e.target.value) || 30)); config.delayBetweenBatches = seconds * 1000; e.target.value = seconds; saveConfig(); }); document.getElementById('skip-followers').addEventListener('change', (e) => { config.skipFollowers = e.target.checked; saveConfig(); }); document.getElementById('start-unfollow').addEventListener('click', startMassUnfollow); document.getElementById('stop-unfollow').addEventListener('click', stopMassUnfollow); } // Get the user cell container from an unfollow button function getUserCell(button) { // Traverse up to find the user cell container (usually has data-testid="UserCell") let element = button; while (element && element !== document.body) { if (element.getAttribute('data-testid') === 'UserCell') { return element; } element = element.parentElement; } // Fallback: go up several levels to find a reasonable container return button.closest('[data-testid="UserCell"]') || button.parentElement?.parentElement?.parentElement?.parentElement?.parentElement; } // Check if a user follows you back function userFollowsBack(button) { const userCell = getUserCell(button); if (!userCell) return false; // Look for "Follows you" text in the user cell const cellText = userCell.textContent || ''; return cellText.includes('Follows you'); } // Get all unfollow buttons with follower status function getUnfollowButtonsWithStatus() { const buttons = Array.from(document.querySelectorAll('[data-testid$="-unfollow"]')); return buttons.map(button => ({ button, followsBack: userFollowsBack(button) })); } // Update status display function updateStatus(message, color = '#e7e9ea') { const statusEl = document.getElementById('status'); if (statusEl) { statusEl.textContent = message; statusEl.style.color = color; } } // Sleep function function sleep(ms) { return new Promise(resolve => setTimeout(resolve, ms)); } // Unfollow a single user async function unfollowUser(button) { try { // Scroll button into view button.scrollIntoView({ behavior: 'smooth', block: 'center' }); await sleep(200); // Click the button button.click(); await sleep(500); // Find and click the confirm button in the modal (if it appears) const confirmButton = document.querySelector('[data-testid="confirmationSheetConfirm"]'); if (confirmButton) { confirmButton.click(); await sleep(300); } // Check if button is still there (if not, unfollow was successful) const stillExists = document.querySelector(`[data-testid="${button.getAttribute('data-testid')}"]`); return !stillExists || stillExists.getAttribute('aria-label')?.includes('Follow'); } catch (error) { console.error('Error unfollowing user:', error); return false; } } // Main mass unfollow function with batch support async function startMassUnfollow() { if (isRunning) return; isRunning = true; unfollowCount = 0; skippedCount = 0; currentBatch = 0; // Update UI document.getElementById('start-unfollow').style.display = 'none'; document.getElementById('stop-unfollow').style.display = 'block'; const totalBatches = config.numBatches; const batchSize = config.batchSize; // Get buttons with follower status const buttonsWithStatus = getUnfollowButtonsWithStatus(); // Filter based on settings const buttonsToProcess = config.skipFollowers ? buttonsWithStatus.filter(item => !item.followsBack) : buttonsWithStatus; const totalFollowers = buttonsWithStatus.filter(item => item.followsBack).length; const skipMsg = config.skipFollowers ? ` (skipping ${totalFollowers} followers)` : ''; if (buttonsToProcess.length === 0) { if (config.skipFollowers && totalFollowers > 0) { updateStatus(`No non-followers to unfollow (${totalFollowers} followers skipped)`, '#ffd400'); } else { updateStatus('No users to unfollow found', '#f4212e'); } stopMassUnfollow(); return; } // Process batches for (let batchNum = 0; batchNum < totalBatches && isRunning; batchNum++) { currentBatch = batchNum + 1; const startIdx = batchNum * batchSize; const endIdx = Math.min(startIdx + batchSize, buttonsToProcess.length); const batchButtons = buttonsToProcess.slice(startIdx, endIdx); if (batchButtons.length === 0) { updateStatus(`Batch ${currentBatch}/${totalBatches}: No more users to unfollow`, '#ffd400'); break; } updateStatus(`Starting Batch ${currentBatch}/${totalBatches} (${batchButtons.length} users)...${skipMsg}`, '#1d9bf0'); // Process unfollows in this batch for (let i = 0; i < batchButtons.length && isRunning; i++) { const { button } = batchButtons[i]; const globalIndex = unfollowCount + i + 1; updateStatus(`Batch ${currentBatch}/${totalBatches}: Unfollowing ${i + 1}/${batchButtons.length}... (${globalIndex} total)${skipMsg}`, '#1d9bf0'); const success = await unfollowUser(button); if (success) { unfollowCount++; await sleep(config.delayBetweenUnfollows); } else { console.warn('Failed to unfollow user at index', i); await sleep(config.delayBetweenUnfollows); } } // Wait between batches (except after the last batch) if (batchNum < totalBatches - 1 && isRunning) { const waitSeconds = Math.round(config.delayBetweenBatches / 1000); for (let i = waitSeconds; i > 0 && isRunning; i--) { updateStatus(`Batch ${currentBatch}/${totalBatches} complete. Next batch in ${i}s... (${unfollowCount} total unfollowed)`, '#ffd400'); await sleep(1000); } } } // Finished const skippedMsg = config.skipFollowers ? ` (${totalFollowers} followers preserved)` : ''; if (isRunning) { updateStatus(`✓ Completed! Unfollowed ${unfollowCount} users!${skippedMsg}`, '#00ba7c'); } else { updateStatus(`Stopped. Unfollowed ${unfollowCount} users.${skippedMsg}`, '#ffd400'); } stopMassUnfollow(); } // Stop mass unfollow function stopMassUnfollow() { isRunning = false; document.getElementById('start-unfollow').style.display = 'block'; document.getElementById('stop-unfollow').style.display = 'none'; } // Register menu command GM_registerMenuCommand('Open Mass Unfollower', () => { if (!document.getElementById('mass-unfollow-panel')) { createControlPanel(); } }); // Auto-show control panel on page load - ALWAYS VISIBLE window.addEventListener('load', () => { setTimeout(() => { if (!document.getElementById('mass-unfollow-panel')) { createControlPanel(); } }, 2000); }); console.log('Twitter/X Mass Unfollower v4.0 loaded! Control panel is always visible on the right side.'); })();