TikTok AutoBlocker

A powerful tool for mass blocking TikTok users with support for both Chrome extensions and Tampermonkey scripts. Features enhanced private account detection, real-time status updates, and robust error handling. Now Available on Chrome Web Store!!

🚀 Features

Core Functionality

• Mass Blocking: Upload text files with usernames and automatically block them all
• Private Account Support: Automatically detects and handles private TikTok accounts
• Real-time Status Updates: Live progress feedback during blocking operations
• Enhanced Error Handling: Gracefully handles deleted, banned, or inaccessible accounts
• Block List Management: Add users, download blocklists, and upload existing lists

Advanced Features

• 3-Step Blocking Process: Reliable blocking sequence that works with TikTok's current interface
• Account Accessibility Detection: Smart detection of accessible vs. inaccessible accounts
• Multiple URL Pattern Support: Handles various TikTok URL formats
• Comprehensive Logging: Detailed console output for debugging and monitoring
• Queue Management: Robust task queue system for processing large lists
• Cross-browser Compatibility: Tampermonkey version works in Chrome, Firefox, Safari, Edge, and more

📁 Project Structure

tiktok-autoblocker/
├── chrome-extension/       # Chrome extension version
│   ├── manifest.json       # Extension configuration
│   ├── content.js          # Content script for TikTok pages
│   ├── popup.html          # Popup interface
│   ├── popup.js            # Popup logic
│   ├── background.js       # Background service worker
│   ├── icons/              # Extension icons
│   └── INSTALL.md          # Installation guide
├── tampermonkey/           # Tampermonkey script version
│   ├── script.js           # Main Tampermonkey script
│   └── test-blocklist.txt  # Test blocklist file
├── README.md               # This file
└── test-blocklist.txt      # Sample blocklist for testing

🛠️ Installation Options

Option 1: Chrome Extension (Recommended)

• Pros: Modern UI, integrated popup, persistent storage, available on Chrome Web Store
• Cons: Requires Chrome browser

Installation from Chrome Web Store (Easiest)

1. Visit TikTok AutoBlocker on Chrome Web Store
2. Click "Add to Chrome"
3. Confirm the installation
4. The extension will appear in your browser toolbar

Development Installation

1. Download the extension files

   • Clone or download this repository
   • Navigate to the chrome-extension folder

2. Create required icons

   • Convert icons/icon.svg to PNG format
   • Create icon16.png (16x16), icon48.png (48x48), and icon128.png (128x128)
   • Place them in the icons/ folder

3. Install in Chrome

   • Open Chrome and navigate to chrome://extensions/
   • Enable "Developer mode" in the top right corner
   • Click "Load unpacked" and select the chrome-extension folder
   • The extension should now appear in your extensions list

Option 2: Tampermonkey Script

• Pros: Works in any browser with Tampermonkey, lightweight
• Cons: Requires Tampermonkey extension

Prerequisites

Before you can use the TikTok AutoBlocker script, you must install Tampermonkey. Tampermonkey is a popular userscript manager that's available as a browser extension.

Installing Tampermonkey:

Chrome:

1. Visit Chrome Web Store - Tampermonkey
2. Click "Add to Chrome"
3. Confirm the installation

Firefox:

1. Visit Firefox Add-ons - Tampermonkey
2. Click "Add to Firefox"
3. Confirm the installation

Other Browsers:

• Search for "Tampermonkey" in your browser's extension store
• Follow the installation instructions for your specific browser

Installing the Script

Once Tampermonkey is installed, follow these steps:

1. Open Tampermonkey Dashboard

   • Click the Tampermonkey icon in your browser toolbar
   • Select "Dashboard" or "Create a new script"

2. Create New Script

   • Click "Create a new script" in the Tampermonkey dashboard
   • This will open the script editor

3. Copy the Script

   • Open the file tampermonkey/script.js from this repository
   • Copy the entire contents of the file

4. Paste and Save

   • Paste the copied script into the Tampermonkey script editor
   • Press Ctrl + S (or Cmd + S on Mac) to save the script
   • The script should now be enabled and ready to use

📋 Usage

File Format

Your blocklist text file should contain usernames, one per line:

@kimkardashian
@diddy
@jlo
@username1
@username2

Chrome Extension Usage

Adding Users to Block List

1. Navigate to any TikTok user's profile page
2. Click the TikTok AutoBlocker extension icon in your browser toolbar
3. Click "Add Current User to Block List" to add them to your blocklist

Downloading Your Block List

1. Click the extension icon
2. Click "Download Block List" to download your current blocklist as a .txt file

Mass Blocking Users

1. Create a text file with one username per line (e.g., @username1, @username2)
2. Click the extension icon
3. Click "Upload Block List (.txt)" and select your file
4. The extension will automatically start blocking all users in the list

Tampermonkey Script Usage

Adding Users to Block List

1. Navigate to any TikTok user's profile page
2. Look for the "TikTok AutoBlocker" card in the top-right corner of the page
3. Click "Add User to Block List" to add the current user to your blocklist

Downloading Your Block List

1. On any TikTok page, find the TikTok AutoBlocker card
2. Click "Download Block List" to download your current blocklist as a .txt file
3. The file will be saved to your default downloads folder

Mass Blocking Users

1. Create a blocklist file

   • Create a text file with one username per line

   • Example format:

     @kimkardashian
     @diddy
     @jlo
     @username1
     @username2
     

2. Upload and process

   • Navigate to any TikTok page
   • In the TikTok AutoBlocker card, click "Upload Block List (.txt)"
   • Select your text file
   • The script will automatically start blocking all users in the list

Basic Workflow

1. Create a blocklist: Add usernames to a text file
2. Upload the file: Use the upload feature in either version
3. Monitor progress: Watch real-time status updates
4. Download results: Save your blocklist for future use

🔧 Technical Details

Architecture

Chrome Extension:

• Manifest V3: Uses the latest Chrome extension manifest version
• Content Script: Runs on TikTok pages to handle blocking operations
• Popup Interface: Modern UI for user interactions
• Background Service Worker: Handles extension lifecycle and background tasks
• Chrome Storage: Uses chrome.storage.local for data persistence

Tampermonkey Script:

• Cross-browser Compatibility: Works in Chrome, Firefox, Safari, Edge, and more
• Local Storage: Uses localStorage for data persistence
• Content Script: Runs directly on TikTok pages
• UI Integration: Integrates with TikTok's page layout

Blocking Process

Both versions use a sophisticated 3-step blocking sequence:

1. Click "More" button ([data-e2e="user-more"])
2. Click "Block" option (div[role="button"][aria-label="Block"])
3. Confirm blocking (button[data-e2e="block-popup-block-btn"], button[class*="Button-StyledButtonBlock"])

Private Account Detection

Advanced detection for private accounts:

• DOM element indicators ([data-e2e="private-account"])
• Text content analysis ("This account is private")
• User subtitle detection ("Private")
• Multiple fallback strategies

Error Handling

• Inaccessible accounts: Automatically skipped with logging
• Failed blocking: Added to blocklist as fallback
• Network issues: Retry mechanisms and graceful degradation
• Queue management: Continues processing even if some accounts fail
• @N/A username protection: Prevents infinite refresh loops when encountering invalid usernames

URL Pattern Support

Both versions handle various TikTok URL formats:

• /@username (with @ symbol)
• /username (without @ symbol)
• /user/username (alternative format)
• Fallback for any TikTok page

🐛 Troubleshooting

Chrome Extension Issues

Extension not loading:

• Make sure all required files are present
• Check that the manifest.json file is valid JSON
• Ensure icons are in PNG format and the correct sizes
• Check Chrome's extension page for error messages

Extension not working on TikTok:

• Make sure you're on a TikTok page (tiktok.com domain)
• Check the browser console for any error messages
• Try refreshing the TikTok page
• Ensure the extension has the necessary permissions

Blocking not working:

• Ensure you're on a TikTok profile page
• Check console logs for detailed error information
• Try the debug features to analyze page structure

Tampermonkey Script Issues

Script not appearing on TikTok pages:

1. Check if Tampermonkey is installed and enabled
2. Verify the script is enabled in Tampermonkey dashboard
3. Check browser console for error messages
4. Try refreshing the TikTok page

Blocking not working:

1. Ensure you're on a TikTok profile page
2. Check console logs for detailed error information
3. Look for the red test box that appears for 5 seconds
4. Verify the UI card appears in the top-right corner

Script not loading:

1. Check Tampermonkey dashboard for script errors
2. Verify the script is saved and enabled
3. Try reinstalling the script
4. Check browser console for JavaScript errors

Debug Features

Both versions include comprehensive debugging:

• Page structure analysis: Analyze current page elements
• Step-by-step blocking tests: Test the blocking process manually
• Debug log export: Export detailed logs to file
• Real-time status monitoring: Live progress feedback
• Clear stuck tasks: Reset the blocking queue if needed

Getting Help

If you're still having issues:

1. Check the browser console for error messages
2. Review the console logs for detailed error information
3. Try the debug features to analyze page structure
4. Open an issue on the GitHub repository with detailed information

📈 Version History

v0.3.0 (Current)

• ✅ Enhanced private account detection
• ✅ Improved 3-step blocking sequence
• ✅ Better error handling and accessibility checks
• ✅ Multiple URL pattern support
• ✅ Comprehensive logging and debugging
• ✅ Robust queue management
• ✅ Real-time status updates
• ✅ @N/A username protection to prevent infinite refresh loops
• ✅ Updated block button selectors for improved reliability

v0.2.0

• ✅ Private account support
• ✅ Real-time status updates
• ✅ Enhanced error handling
• ✅ Modern UI design

v0.1.0

• ✅ Basic blocking functionality
• ✅ File upload/download
• ✅ Simple UI

🔒 Security & Privacy

• Local Storage: All data is stored locally in your browser
• No External Servers: Neither version sends data to any external servers
• Open Source: Full source code is available for review
• Privacy Focused: No tracking or data collection

📄 License

This project is licensed under the MIT License.

⚠️ Disclaimer

This tool is intended for personal use and should be used responsibly. The creators are not responsible for any misuse or consequences arising from the use of this tool. Please respect TikTok's terms of service and use this tool ethically.

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📞 Support

For support, please:

1. Check the troubleshooting section above
2. Review the console logs for error messages
3. Open an issue on the GitHub repository with detailed information