Universal Bulk Address Book Deduplicator

WHAT IT DOES

Universal Bulk Address Book Deduplicator helps you clean up contact lists by automatically detecting and removing duplicate entries. Instead of manually scrolling through your address book and comparing entries one by one — this tool provides a unified checklist of all contacts on the current page. You can filter contacts by name or email to quickly find specific entries. The tool automatically identifies duplicate contacts based on matching emails, phone numbers, or similar names using fuzzy matching algorithms. Select any number of duplicate contacts using checkboxes and click Remove. The tool then automatically processes each selected duplicate — triggering the site's deletion or removal action. This turns what could be a tedious manual cleanup operation into a single batch action, making address book management significantly faster and more accurate.

WHERE IT RUNS

This script runs on virtually any web page that displays a list of contacts — Gmail, Outlook, iCloud, LinkedIn, CRM systems, and more. It activates on contact list views and address book pages across the web. It requires the BotGentz extension to inject and execute the script. The tool does not work on mobile apps or native clients — only on the web-based versions of address book applications accessed through a Chromium-based or Firefox browser. It specifically targets *://*/*, meaning it can be used on any website with a contact list.

HOW TO USE

After installing the script via BotGentz, navigate to any address book or contact list page — for example, Gmail Contacts, Outlook People, or your CRM's contact list. The tool automatically detects the contact list and displays a floating panel on the right side. The panel shows all contacts on the current page, with checkboxes next to each contact entry. Each contact displays its name, email, and phone number if available. Use the search box to filter by name or email to narrow down your selection. Adjust the fuzzy match slider to control how similar names need to be to be considered duplicates — a lower value means stricter matching, a higher value catches more variations. Click "Find Duplicates" to identify duplicate groups; duplicates are highlighted in red. Check the boxes for every duplicate contact you want to remove. Click "Remove Selected Duplicates" and confirm the action. The tool will process each selected contact one by one — triggering the site's deletion action for each. A status message appears when the operation completes, showing how many duplicates were removed.

THE ACTUAL MECHANISM — WHY IT WORKS

This tool is designed to work universally across different address book applications. It scans the DOM for contact items using common selector patterns found in contact lists across the web, extracting names, emails, and phone numbers from the visible text content and data attributes. For duplicate detection, the tool uses three methods: exact email matching, exact phone number matching (normalized to remove formatting), and fuzzy name matching using the Levenshtein distance algorithm. The fuzzy matching threshold is adjustable via a slider, allowing you to control how aggressively duplicates are identified — from exact matches only to matches with up to 50% difference. This approach works without making direct API calls, which would require authentication credentials and knowledge of each site's internal API structure. By reading the rendered DOM and interacting with the existing UI, the tool works within each site's own permission and validation system, and continues to function even if the underlying API changes. The tool also detects and uses the site's own delete/remove buttons, ensuring actions are properly authorized.

THE PANEL

The floating panel is fully draggable — click and drag the header to reposition it anywhere on the page. The panel's position is saved per site in localStorage, so it reappears exactly where you left it. Double-click the header to snap the panel to the nearest edge (left or right). A collapse button minimizes the panel to a small tab showing a person emoji badge, keeping it out of the way while still accessible. The contact list inside the panel is scrollable and resizes vertically based on the number of contacts. Pressing Escape while the panel is focused closes it completely; reopening is done via a small button injected near the page header. All panel interactions are non-blocking — the host site's main UI remains fully responsive while the panel is open, and the panel updates automatically when you navigate between pages.

PLEASE NOTE

This script requires the BotGentz extension (free) to run user scripts. It works on a best-effort basis across different address book applications; some sites may have unique DOM structures that require updates if the tool stops working. Check for updated versions within BotGentz's script repository if you encounter issues. This tool does not store, transmit, or log any contact data — all operations occur locally in your browser with no external network requests except those made by the host site itself. Deletions are applied through the host site's own UI event system, so all changes respect your account permissions and data policies. The tool does not bypass any site's security or permission system; it simply automates the clicks you would otherwise perform manually. For large contact lists, the tool may take several minutes to complete the operation. The fuzzy matching threshold should be adjusted based on your data quality — lower values (10-20%) are recommended for well-maintained lists, higher values (30-40%) for lists with inconsistent naming. Always verify duplicate detection results before removing contacts, as fuzzy matching may occasionally flag legitimate unique contacts as duplicates.