🎮 Twitch Unfollow Pro

The most intuitive and powerful Twitch unfollow tool - Bulk unfollow with confidence using our advanced interface with previews, confirmations, and safety features.

A professional Chrome extension for managing your Twitch follows safely and efficiently

---

✨ Features

🛡️ Safety First

• Preview Mode: See exactly what will happen before making changes
• Multiple Confirmations: Multiple safety checks to prevent accidents
• Cancel Anytime: Stop the process at any moment
• Progress Tracking: Real-time progress with detailed status updates

🎯 Intuitive Interface

• 4-Step Workflow: Analyze → Select → Preview → Execute
• Smart Selection: Select individual channels or use bulk operations
• Search & Filter: Find specific channels quickly
• Visual Feedback: Clear indicators for selected and excluded channels

⚡ Powerful Tools

• Bulk Operations: Select all, deselect all, or custom selections
• Keep Following: Move channels to "Keep Following" to exclude them
• Real-time Updates: Live progress tracking during unfollow process
• Data Persistence: Your selections are saved automatically

🚀 Quick Start

Installation

1. Download the Extension

   • Clone this repository or download the ZIP file
   • Extract to a folder on your computer

2. Install in Chrome

   • Open Chrome and go to chrome://extensions/
   • Enable "Developer mode" (top right toggle)
   • Click "Load unpacked" and select the extension folder

3. Start Using

   • Click the extension icon in your browser
   • Navigate to your Twitch following page
   • Follow the 4-step process to manage your follows

Usage

Step 1: Analyze

• Click "Start Analysis" to scan your Twitch following list
• The extension will automatically load all your followed channels

Step 2: Select

• All Channels Panel: Select channels you want to unfollow
• Keep Following Panel: Move channels you want to keep
• Use search to find specific channels quickly
• Use bulk selection buttons for efficiency

Step 3: Preview

• Review exactly what will happen
• See statistics: Total, Keeping, Unfollowing
• Make final adjustments if needed

Step 4: Execute

• Confirm your selection
• Watch real-time progress
• Cancel anytime if needed

🎨 Interface Overview

Main Interface

┌─────────────────────────────────────────────────────────┐
│ 🎮 Twitch Unfollow Pro                                  │
├─────────────────────────────────────────────────────────┤
│ [Step 1] Analyze → [Step 2] Select → [Step 3] Preview  │
├─────────────────────────────────────────────────────────┤
│ All Channels          │ Keep Following                  │
│ [Search]              │ [Search]                        │
│ [Select All] [Move →] │ [Select All] [Clear All]        │
│ ┌─────────────────┐   │ ┌─────────────────┐             │
│ │ Channel 1 ☐     │   │ │ Channel A ☑     │             │
│ │ Channel 2 ☑     │   │ │ Channel B ☑     │             │
│ │ Channel 3 ☐     │   │ └─────────────────┘             │
│ └─────────────────┘   │                                 │
└─────────────────────────────────────────────────────────┘

Selection Modes

• Individual Selection: Click any channel to select/deselect
• Bulk Selection: Use "Select All" for mass operations
• Keep Following: Move channels to exclude them from unfollowing
• Search: Find specific channels by name

🔧 Technical Details

Architecture

• Manifest V3: Latest Chrome extension standard
• Content Scripts: Direct integration with Twitch pages
• Background Service: Handles extension lifecycle
• Storage API: Saves user preferences and data

Safety Features

• Rate Limiting: Prevents overwhelming Twitch servers
• Error Handling: Graceful failure recovery
• Data Validation: Ensures data integrity
• User Confirmation: Multiple safety checks

Performance

• Efficient DOM Manipulation: Optimized for large channel lists
• Memory Management: Clean resource handling
• Async Operations: Non-blocking user interface
• Progress Tracking: Real-time status updates

📊 Statistics & Analytics

The extension tracks:

• Total Channels: Number of channels analyzed
• Unfollowed Count: Total channels unfollowed
• Last Analysis: When you last analyzed your follows
• Success Rate: Percentage of successful operations

🛠️ Development

Prerequisites

• Chrome browser
• Basic knowledge of JavaScript
• Chrome extension development tools

Local Development

# Clone the repository
git clone https://github.com/jiroaku/unfollowr.git
cd unfollowr

# Load in Chrome
# 1. Open chrome://extensions/
# 2. Enable Developer mode
# 3. Click "Load unpacked"
# 4. Select the project folder

File Structure

unfollowr/
├── manifest.json          # Extension configuration
├── popup.html            # Extension popup interface
├── popup.js              # Popup functionality
├── background.js         # Background service worker
├── html.js               # Interface injection
├── script.js             # Main application logic
├── style.css             # Styling and animations
├── icon.png              # Extension icon
└── README.md             # This file

🤝 Contributing

We welcome contributions! Here's how you can help:

Reporting Issues

• Use the GitHub Issues page
• Provide detailed information about the problem
• Include steps to reproduce the issue

Suggesting Features

• Open a new issue with the "Feature Request" label
• Describe the feature and its benefits
• Include mockups or examples if possible

Code Contributions

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Twitch Community: For feedback and suggestions
• Open Source Community: For inspiration and tools

📞 Support

Need help? Here's how to get support:

• GitHub Issues: Create an issue
• Documentation: Check this README and inline code comments

🔮 Roadmap

Version History

• v1.0.0 (Current): Initial release with core functionality
• v1.1.0 (Planned): Enhanced UI and performance improvements
• v1.2.0 (Planned): Advanced filtering and analytics

---

Made with ❤️ by jiroaku

If you find this extension helpful, please consider giving it a ⭐ on GitHub!