{"id":26644948,"url":"https://github.com/rahulsamant37/email-auto_unsubscriber","last_synced_at":"2026-05-06T05:31:39.845Z","repository":{"id":284077369,"uuid":"953746575","full_name":"rahulsamant37/Email-Auto_UnSubscriber","owner":"rahulsamant37","description":"Email-Auto-Unsubscriber is an intelligent tool that automatically identifies and unsubscribes from unwanted email subscriptions in Gmail, streamlining inbox management.","archived":false,"fork":false,"pushed_at":"2025-03-24T02:51:48.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T03:26:48.835Z","etag":null,"topics":["asyncio-python","beautifulsoup","gmail-api","python","python-dotenv","requests","streamlit","tldextract"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rahulsamant37.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-24T02:24:57.000Z","updated_at":"2025-03-24T02:56:16.000Z","dependencies_parsed_at":"2025-03-24T03:26:56.224Z","dependency_job_id":"8596bb50-c379-449c-a3b0-60194ca4aa2a","html_url":"https://github.com/rahulsamant37/Email-Auto_UnSubscriber","commit_stats":null,"previous_names":["rahulsamant37/email-auto_unsubscriber"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulsamant37%2FEmail-Auto_UnSubscriber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulsamant37%2FEmail-Auto_UnSubscriber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulsamant37%2FEmail-Auto_UnSubscriber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulsamant37%2FEmail-Auto_UnSubscriber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rahulsamant37","download_url":"https://codeload.github.com/rahulsamant37/Email-Auto_UnSubscriber/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245352285,"owners_count":20601122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asyncio-python","beautifulsoup","gmail-api","python","python-dotenv","requests","streamlit","tldextract"],"created_at":"2025-03-24T21:21:03.651Z","updated_at":"2026-05-06T05:31:39.793Z","avatar_url":"https://github.com/rahulsamant37.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Email Auto-Unsubscriber 🚀\n\nAn intelligent tool that helps you reclaim your inbox by automatically unsubscribing from unwanted email subscriptions in Gmail.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/b0807537-c3da-469a-b459-2c5e7d81bf88\" width=\"80%\" alt=\"Development Journey Banner\" className=\"flex justify-between item-center\"\u003e\n\u003c/div\u003e\n\n## 🌟 Key Features\n\n- **Smart Gmail Integration**: Secure connection using OAuth2\n- **Intelligent Processing**: \n  - Finds hidden unsubscribe links in email headers and body\n  - Groups emails by sender to avoid duplicate unsubscribes\n  - Handles both one-click and form-based unsubscribe pages\n- **Progress Tracking**: \n  - Real-time console updates\n  - Detailed logging of all actions\n  - CSV export of results\n- **Safety First**:\n  - Rate limiting to avoid Gmail API restrictions\n  - Automatic retry on failed attempts\n  - Backup of all processed links\n\n## 🚀 Quick Start\n\n1. **Set Up Your Environment**\n```bash\ngit clone https://github.com/rahulsamant37/Email-Auto_UnSubscriber.git\ncd email-auto-unsubscriber\npip install -r requirements.txt\n```\n\n2. **Configure Credentials**\n- Create a `.env` file in the project root\n- Add your Gmail credentials:\n```ini\nEMAIL=\"your.email@gmail.com\"\nPASSWORD=\"your-app-password\"\n```\n\n3. **Run the Tool**\n```bash\npython main.py\n```\n\n## 📋 Prerequisites\n\n- Python 3.8+\n- Gmail account\n- Gmail App Password (for 2FA-enabled accounts)\n- Required packages listed in `requirements.txt`\n\n## 🔒 Security Note\n\nThis tool requires a Gmail App Password. Never use your regular Gmail password!\n\nTo set up an App Password:\n1. Go to [Google Account Security](https://myaccount.google.com/security)\n2. Enable 2-Step Verification\n3. Generate an App Password at [App Passwords](https://myaccount.google.com/apppasswords)\n\n## 📊 Output Files\n\nThe tool generates two key files:\n\n| File | Description |\n|------|-------------|\n| `unsubscribe_links.txt` | Complete list of discovered unsubscribe links |\n| `unsubscribe_services.csv` | Structured data with sender info and results |\n\n![image](https://github.com/user-attachments/assets/b8983c11-819e-4781-8b54-0c9f03821158)\n\n![image](https://github.com/user-attachments/assets/6c70c3e2-a7b8-498d-9ab5-2fd90453faab)\n\n\n## 📈 Progress Monitoring\n\nWatch your unsubscribe progress in real-time:\n```\n✓ Connected to Gmail\n📧 Found 150 subscription emails\n🔍 Identified 45 unique services\n⚡ Processing unsubscribe requests...\n[====================] 100% Complete\n✅ Successfully unsubscribed: 42\n❌ Failed attempts: 3\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how you can help:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## ⚠️ Disclaimer\n\nThis tool is for personal use only. Ensure you have proper authorization to access the Gmail account you're using. The developers are not responsible for any misuse or violations of terms of service.\n\n## 🐛 Troubleshooting\n\nCommon issues and solutions:\n\n- **API Rate Limits**: The tool automatically handles Gmail API quotas\n- **Connection Issues**: Check your App Password and internet connection\n- **Unsubscribe Failures**: Some services may require manual unsubscription\n\nFor more help, check our [Issues](https://github.com/rahulsamant37/Email-Auto_UnSubscriber/issues) page.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahulsamant37%2Femail-auto_unsubscriber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahulsamant37%2Femail-auto_unsubscriber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahulsamant37%2Femail-auto_unsubscriber/lists"}