- 🚀 Features
- 💻 Requirements
- 🛠️ Installation
- ⚙️ Configuration
- 📝 Input Files Structure
- 📊 Results
- 🚀 Usage
- 🔒 oAuth2/IMAP support
- 🌐 Full proxy support (HTTP/SOCKS5)
- ⚡ Multi-threaded operations
- 📊 Comprehensive account results
- Python 3.10-3.11
- Stable internet connection
- Working proxies (HTTP/SOCKS5) (optional)
- Email accounts
-
Clone the Repository
git clone [repository URL]
-
Set Up Virtual Environment
python -m venv venv source venv/Scripts/activate # Windows source venv/bin/activate # Unix/MacOS
-
Install Dependencies
pip install -r requirements.txt
threads: 50 # Number of concurrent threads to run (minimum: 1)
retry_limit: 1 # Number of times to retry on failure (minimum: 1) - for example if proxy fails to connect to the server or email fails to login etc.
use_oauth: false # Use OAuth2 (most used for outlook/hotmail) (true/false)
use_proxy: false # Use proxy while checking emails (true/false)
# Email Provider IMAP Settings
# --------------------------
imap_settings:
# Common email providers and their IMAP servers
gmail.com: imap.gmail.com # Google
yahoo.com: imap.mail.yahoo.com # Yahoo
mail.ru: imap.mail.ru # Mail.ru
rambler.ru: imap.rambler.ru # Rambler
gmx.com: imap.gmx.com # GMX
gmx.net: imap.gmx.net # GMX Germany
gmx.de: imap.gmx.net # GMX Germany (alternate domain)
mesiosemail.ru: imap.firstmail.ltd # FirstMail
superasemail.ru: imap.firstmail.ltd # FirstMail
outlook.com: imap-mail.outlook.com # Outlook.com
hotmail.com: imap-mail.outlook.com # Hotmail
# you can add more email providers here like:
# domain.com: imap.domain.com
# domain2.com: imap.domain2.com
Standard Format
email:password
email:password
# OR
email|password
email|password
# Extended format (additional data will be ignored)
email:password:extra_data1:extra_data2
email|password|extra_data1|extra_data2
OAuth2 Format
email:client_id:refresh_token
email|client_id|refresh_token
http://user:pass@ip:port
socks5://user:pass@ip:port
http://ip:port:user:pass
socks5://ip:port:user:pass
http://user:pass:ip:port
socks5://user:pass:ip:port
The checker creates organized result files in the following structure:
📁 results/
├── 📄 connection_error.txt # Failed server connections (proxy issues)
├── 📄 invalid_credentials.txt # Failed logins (incorrect credentials)
└── 📄 success.txt # Successfully verified accounts
Result Types:
-
connection_error.txt: Contains accounts that failed to connect (usually due to proxy issues)
-
invalid_credentials.txt: Lists accounts with incorrect login credentials
-
success.txt: Records all successfully verified accounts
- Configure your settings in settings.yaml
- Add your accounts to accounts.txt
- If using proxies, add them to proxies.txt
- Run the checker:
python run.py