Facebook Bulk Unfriend Inactive Accounts

WHAT IT DOES

This tool helps you clean up your Facebook friends list by identifying and unfriending accounts that have been inactive for a specified period. It scans your friends list, analyzes each friend's recent activity based on visible indicators like "last active" timestamps and recent posts, and presents all inactive friends in a scrollable list with profile pictures and checkboxes. You can then bulk unfriend selected accounts with a single click. The tool also allows you to ignore specific friends to exclude them from future scans and includes an option to include friends with limited profile visibility in the scan.

WHERE IT RUNS

The script runs directly inside the Facebook web page on your friends list. It does not require a separate extension popup, background process, or external server. Everything happens within the page context, interacting with Facebook's DOM components and React-based interface. It works on the desktop version of Facebook when viewing your friends list.

HOW TO USE

1. Navigate to your Facebook friends list (facebook.com/yourusername/friends).

2. Open the BotGentz panel and set the inactivity threshold in days (default is 180).

3. Optionally toggle "Include limited profile friends" if you want to scan friends with restricted visibility.

4. Click "Scan & Unfriend" to start the process.

5. The script will automatically scroll through your friends list to load all friends, analyze activity timestamps, and filter those inactive beyond the threshold.

6. A list of inactive friends appears with profile pictures and checkboxes.

7. Select the friends you want to unfriend (all are checked by default).

8. Click "Unfriend Selected" to begin. The script will click the Friends button, select Unfriend from the dropdown, and confirm the action in batches to avoid rate limits.

9. Use "Ignore Selected" to add friends to an ignore list so they are not shown in future scans.

TECHNICAL MECHANISM

Unlike browser extensions that rely on Facebook's private Graph API, this script operates purely on the public DOM. It detects friend inactivity by parsing date strings from the page, including "X days ago", "X weeks ago", "yesterday", and "today" indicators found in friend cards and activity timestamps. The script scrolls the friends list programmatically, loading friends dynamically as the user would by scrolling. For unfriending, it uses event-driven interaction: it clicks the Friends button, identifies the Unfriend menu item by text content using role-based selectors, and programmatically clicks the confirm button in the modal dialog. All actions include retry logic with exponential backoff and spacing to account for React's asynchronous rendering and to avoid triggering Facebook's rate limiting or temporary action blocks. The script includes a fallback mechanism to locate the Friends button and Unfriend option even when Facebook's class names change, using aria-label attributes and role-based selectors.

THE PANEL

The tool appears as a draggable, resizable panel on the side of your screen. You can drag it to any position by clicking and holding the header, resize it by dragging the bottom-right corner, and collapse it to a small bubble when not in use. Press the Escape key to close the panel. The panel remembers its position and size per site (facebook.com) so it stays where you left it on your next visit.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not store any personal data except for a list of ignored friend IDs, which is saved locally in your browser using GM_setValue. No data is sent to any external server. Facebook frequently updates its website, which may break the script. If you encounter issues, check for updates or contact support. Use responsibly and respect Facebook's terms of service. Unfriending many friends in a short time may trigger temporary action blocks.