diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a760a40
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,14 @@
+# Local secrets and generated account data
+config/password.txt
+config/5sim_config.txt
+data/accounts.json
+
+# Python/cache/build artifacts
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.venv/
+venv/
+build/
+dist/
+*.spec
diff --git a/README.md b/README.md
index a8f8d47..43623dc 100644
--- a/README.md
+++ b/README.md
@@ -220,11 +220,13 @@ Before running the tool, you need to configure the following files:
#### 3.1. Password Configuration
-Edit `config/password.txt`:
-```
-YourStrongPassword123!
+Create your local password file from the example, then edit it:
+```bash
+cp config/password.example.txt config/password.txt
```
+`config/password.txt` is ignored by git so real passwords are not committed.
+
**Password Requirements:**
- At least 8 characters
- Mix of uppercase, lowercase, numbers, and special characters
@@ -250,11 +252,13 @@ Shadow Hacker
#### 3.3. 5sim API Configuration (Optional but Recommended)
1. **Get your API key** from [5sim.net](https://5sim.net/)
-2. **Add your API key** in `config/5sim_config.txt`:
-```
-your_api_key_here
+2. **Create your local API-key file** from the example, then edit it:
+```bash
+cp config/5sim_config.example.txt config/5sim_config.txt
```
+`config/5sim_config.txt` is ignored by git so real API keys are not committed.
+
3. **Configure country** in `config/config.py`:
```python
FIVESIM_COUNTRY = "usa" # Options: usa, russia, ukraine, kazakhstan, etc.
@@ -307,10 +311,10 @@ You should see the welcome banner and menu. If you see any errors, check the [Tr
```
config/
-├── config.py # General settings
-├── password.txt # Account password
-├── 5sim_config.txt # 5sim API key (optional)
-└── user_agents.txt # User agents list (optional)
+├── config.py # General settings
+├── password.example.txt # Template for local password.txt
+├── 5sim_config.example.txt # Template for local 5sim_config.txt
+└── user_agents.txt # User agents list (optional)
data/
├── names.txt # List of names
@@ -355,6 +359,7 @@ data/
---
+
## 🚀 Latest Update (v2.1.0)
### ✨ New Release is Here!
@@ -387,3 +392,606 @@ https://github.com/ShadowHackrs/Gmail-infinity
---
⭐ If you like this update, don’t forget to star the repository!
+
+---
+
+## 🚀 Usage
+
+### Basic Usage
+
+1. **Run the script:**
+ ```bash
+ python auto_gmail_creator.py
+ ```
+
+2. **Select option 1** from the menu to create accounts
+
+3. **Enter the number of accounts** you want to create
+
+4. **Wait for completion** - The script will:
+ - Open Chrome browser automatically
+ - Fill in account information
+ - Handle email selection
+ - Set password
+ - Bypass phone verification (or use 5sim)
+ - Save account details to `data/accounts.json`
+
+### Menu Options
+
+```
+┌─────────────────────────────────────────────────┐
+│ Menu Options │
+├─────────────────────────────────────────────────┤
+│ 1. Create Gmail Accounts 🚀 │
+│ Start creating new Gmail accounts │
+│ │
+│ 2. View Statistics 📊 │
+│ View detailed creation statistics │
+│ │
+│ 3. Settings ⚙️ │
+│ Configure proxy, user agents, and settings │
+│ │
+│ 4. View Saved Accounts 📁 │
+│ View all created accounts and details │
+│ │
+│ 5. Exit 👋 │
+│ Exit the application │
+└─────────────────────────────────────────────────┘
+```
+
+### Account Creation Process
+
+The tool follows these steps for each account:
+
+1. **Browser Initialization**
+ - Creates Chrome driver with anti-detection settings
+ - Sets random user agent
+ - Modifies navigator properties
+
+2. **Session Warming** (Optional)
+ - Visits Google, BBC, Wikipedia, YouTube
+ - Performs random searches
+ - Simulates human browsing behavior
+
+3. **Account Information Entry**
+ - Fills first name and last name
+ - Enters birthday (month, day, year)
+ - Selects gender
+
+4. **Email Selection**
+ - Chooses "Create your own Gmail address" option
+ - Generates username from name + random numbers
+ - Validates username availability
+
+5. **Password Setup**
+ - Enters password in both fields
+ - Validates password strength
+ - Proceeds to next step
+
+6. **Phone Verification**
+ - Attempts to skip phone verification
+ - If skip fails, uses 5sim API (if configured)
+ - Enters verification code automatically
+
+7. **Account Completion**
+ - Saves account to `data/accounts.json`
+ - Displays success message
+ - Closes browser
+
+### Viewing Statistics
+
+Select **Option 2** from the menu to view:
+- Total accounts created
+- Active accounts count
+- Success rate percentage
+- Last creation timestamp
+
+### Viewing Saved Accounts
+
+Select **Option 4** from the menu to view:
+- All created accounts
+- Email addresses
+- Creation dates
+- Account status
+
+---
+
+## 📁 Project Structure
+
+```
+Gmail2025/
+│
+├── auto_gmail_creator.py # Main script
+├── requirements.txt # Python dependencies
+├── README.md # This file
+│
+├── config/ # Configuration files
+│ ├── config.py # General settings
+│ ├── password.example.txt # Template for local password.txt
+│ ├── 5sim_config.example.txt # Template for local 5sim_config.txt
+│ ├── user_agents.txt # User agents list
+│ └── README.txt # Config folder info
+│
+├── data/ # Data files
+│ ├── names.txt # List of names
+│ ├── accounts.json # Created accounts (auto-generated)
+│ └── README.txt # Data folder info
+│
+├── build/ # Build files (PyInstaller)
+│ └── auto_gmail_creator/ # Build artifacts
+│
+├── dist/ # Distribution files
+│ └── auto_gmail_creator.exe # Compiled executable
+│
+└── screenshot.png # Screenshot (add your image here)
+```
+
+---
+
+## 🔧 Advanced Features
+
+### Phone Verification Bypass Strategies
+
+The tool uses multiple strategies to bypass phone verification:
+
+1. **Skip Button Detection**
+ - Automatically finds and clicks skip buttons
+ - Supports English and Arabic skip buttons
+ - Multiple selector strategies
+
+2. **Alternative Methods**
+ - Tries "Try another way" options
+ - Explores alternative verification methods
+ - Looks for skip options in alternative flows
+
+3. **5sim Integration**
+ - Automatic phone number purchase
+ - SMS code retrieval
+ - Support for multiple countries
+ - Automatic retry on failure
+
+4. **Smart Retry Logic**
+ - Multiple fallback strategies
+ - Automatic retry on failure
+ - Error handling and recovery
+
+### Anti-Detection Features
+
+**Human-like Behavior:**
+- Random typing delays (0.1-0.3 seconds per character)
+- Natural mouse movements
+- Random wait times between actions
+- Session warming before account creation
+
+**Browser Fingerprinting:**
+- Random user agent rotation
+- Navigator property modification
+- WebDriver property hiding
+- Plugin simulation
+
+**Realistic Data:**
+- Names from external file
+- Realistic usernames
+- Proper birthday format
+- Natural gender selection
+
+### 5sim API Integration
+
+**Features:**
+- Automatic phone number purchase
+- SMS code retrieval with timeout
+- Support for multiple countries
+- Automatic order management
+- Error handling and retry
+
+**Setup:**
+1. Get API key from [5sim.net](https://5sim.net/)
+2. Add balance to your account
+3. Configure API key in `config/5sim_config.txt`
+4. Set country in `config/config.py`
+
+**Usage:**
+The tool automatically uses 5sim when:
+- Skip button is not available
+- Alternative methods fail
+- Phone verification is required
+
+---
+
+## 🐛 Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. ChromeDriver Error
+
+**Error:**
+```
+selenium.common.exceptions.WebDriverException: Message: 'chromedriver' executable needs to be in PATH
+```
+
+**Solution:**
+- The script automatically downloads ChromeDriver using webdriver-manager
+- If issues persist, manually install ChromeDriver or update Chrome browser
+- Ensure Chrome browser is up to date
+
+#### 2. Phone Verification Required
+
+**Error:**
+```
+Phone verification required but skip button not found
+```
+
+**Solution:**
+- Configure 5sim API key for automatic verification
+- Or manually skip when prompted (the script will try multiple skip strategies)
+- Check if 5sim account has balance
+
+#### 3. Element Not Found Errors
+
+**Error:**
+```
+selenium.common.exceptions.NoSuchElementException: Message: no such element
+```
+
+**Solution:**
+- Google may have updated their UI - check for script updates
+- Check internet connection
+- Try running again (may be temporary issue)
+- Clear browser cache and cookies
+
+#### 4. Import Errors
+
+**Error:**
+```
+ModuleNotFoundError: No module named 'selenium'
+```
+
+**Solution:**
+```bash
+pip install -r requirements.txt
+```
+
+Or install packages individually:
+```bash
+pip install selenium webdriver-manager rich requests unidecode beautifulsoup4 fp
+```
+
+#### 5. Config Files Not Found
+
+**Error:**
+```
+FileNotFoundError: config/password.txt not found
+```
+
+**Solution:**
+- Make sure `config/` and `data/` folders exist
+- Check file paths in `config/config.py`
+- Ensure files are in correct locations
+- Create missing files if needed
+
+#### 6. 5sim API Errors
+
+**Error:**
+```
+5sim API error: 401 - Unauthorized
+```
+
+**Solution:**
+- Check if API key is correct
+- Verify API key in `config/5sim_config.txt`
+- Ensure account has balance
+- Check 5sim.net for API status
+
+#### 7. Password Validation Errors
+
+**Error:**
+```
+Password does not meet requirements
+```
+
+**Solution:**
+- Use strong password (8+ characters)
+- Include uppercase, lowercase, numbers, special characters
+- Check Google's password requirements
+- Update password in `config/password.txt`
+
+#### 8. Names File Empty
+
+**Error:**
+```
+Error: names.txt is empty or not found!
+```
+
+**Solution:**
+- Add names to `data/names.txt`
+- One name per line
+- Format: "First Last" or just "First"
+- Ensure file is not empty
+
+### Debug Mode
+
+For detailed error messages:
+- Check the console output for color-coded status messages
+- Look for detailed error descriptions
+- Monitor progress indicators
+- Check `data/accounts.json` for saved accounts
+
+### Getting Help
+
+If you encounter issues not listed here:
+1. Check the [GitHub Issues](https://github.com/ShadowHackrs/gmail-account-creator/issues)
+2. Contact support (see [Contact & Support](#-contact--support))
+3. Review the error messages carefully
+4. Check internet connection and Chrome browser version
+
+---
+
+## 🔐 Security & Legal
+
+### ⚠️ Important Security Information
+
+**This tool is for educational purposes only.**
+
+- Creating multiple accounts may violate Google's Terms of Service
+- Use responsibly and at your own risk
+- Accounts created may be subject to verification or suspension
+- Keep your API keys secure and never share them
+- Use the provided `.example.txt` files as templates and keep real `config/password.txt`, `config/5sim_config.txt`, and `data/accounts.json` local
+- Config files (`config/`, `data/`) are NOT obfuscated - keep them secure
+
+### Legal Disclaimer
+
+**By using this tool, you agree to:**
+
+- Comply with Google's Terms of Service
+- Follow local laws and regulations
+- Use the tool responsibly
+- Accept responsibility for your actions
+
+**The developers are not responsible for:**
+- Any misuse of this tool
+- Account suspensions or bans
+- Legal consequences
+- Data loss or security breaches
+
+### Security Best Practices
+
+1. **Keep Config Files Secure**
+ - Don't share `config/password.txt`
+ - Don't commit real API keys, passwords, or generated `data/accounts.json`
+ - Don't share `config/5sim_config.txt`
+ - Don't commit sensitive files to Git
+
+2. **Use Strong Passwords**
+ - Follow Google's password requirements
+ - Use unique passwords for each account
+ - Store passwords securely
+
+3. **Protect API Keys**
+ - Don't share 5sim API keys
+ - Use environment variables if possible
+ - Rotate API keys regularly
+
+4. **Monitor Account Activity**
+ - Check account status regularly
+ - Monitor for suspicious activity
+ - Keep accounts secure
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how you can help:
+
+### How to Contribute
+
+1. **Fork the repository**
+2. **Create a feature branch** (`git checkout -b feature/AmazingFeature`)
+3. **Commit your changes** (`git commit -m 'Add some AmazingFeature'`)
+4. **Push to the branch** (`git push origin feature/AmazingFeature`)
+5. **Open a Pull Request**
+
+### Contribution Guidelines
+
+- Follow the existing code style
+- Add comments for complex logic
+- Test your changes thoroughly
+- Update documentation if needed
+- Be respectful and professional
+
+### Reporting Issues
+
+If you find a bug or have a suggestion:
+1. Check if the issue already exists
+2. Create a new issue with:
+ - Clear description
+ - Steps to reproduce
+ - Expected vs actual behavior
+ - Screenshots if applicable
+
+---
+
+## 📞 Contact & Support
+
+### Get in Touch
+
+We're here to help! Reach out to us through any of the following channels:
+
+
+
+**🌐 Website:** [https://www.shadowhackr.com](https://www.shadowhackr.com)
+
+**📘 Facebook:** [www.facebook.com/ShadowHackr](https://www.facebook.com/ShadowHackr)
+
+**📱 WhatsApp:** [+962796668987](https://wa.me/962796668987)
+
+
+
+### Support Channels
+
+- **GitHub Issues** - For bug reports and feature requests
+- **Email** - Contact through website
+- **Facebook** - For general inquiries
+- **WhatsApp** - For direct support
+
+### Response Time
+
+- **GitHub Issues:** Usually within 24-48 hours
+- **Email:** Within 48 hours
+- **WhatsApp:** Usually within a few hours
+- **Facebook:** Usually within 24 hours
+
+---
+
+## 📄 License
+
+**© 2025 Shadow Hacker - All Rights Reserved**
+
+This software is proprietary and confidential. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited.
+
+### License Terms
+
+- This software is provided "as is" without warranty
+- Commercial use requires explicit permission
+- Redistribution is prohibited
+- Modification is allowed for personal use only
+
+### Copyright Notice
+
+All rights reserved. No part of this software may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the copyright holder.
+
+---
+
+## 🎯 Tips for Best Results
+
+### Maximize Success Rate
+
+1. **Use 5sim API** - Significantly improves success rate
+ - Automatic phone verification
+ - Real phone numbers
+ - Higher success rate
+
+2. **Don't Create Too Many Accounts at Once**
+ - Space out account creation
+ - Wait between batches
+ - Avoid rate limiting
+
+3. **Use Strong Passwords**
+ - Follow Google's password requirements
+ - Use unique passwords
+ - Mix of characters
+
+4. **Monitor Success Rate**
+ - Check statistics regularly
+ - Adjust settings if needed
+ - Track account status
+
+5. **Keep Chrome Updated**
+ - Ensures compatibility
+ - Latest security patches
+ - Better performance
+
+6. **Keep Config Files Secure**
+ - Don't share sensitive files
+ - Use strong passwords
+ - Protect API keys
+
+### Best Practices
+
+- **Start Small** - Test with 1-2 accounts first
+- **Monitor Progress** - Watch for errors
+- **Check Accounts** - Verify created accounts work
+- **Backup Data** - Keep copies of `accounts.json`
+- **Update Regularly** - Keep script and dependencies updated
+
+---
+
+## 📊 Statistics & Analytics
+
+### Built-in Statistics
+
+The tool provides detailed statistics:
+
+- **Total Accounts Created** - Count of all created accounts
+- **Active Accounts** - Accounts with "active" status
+- **Success Rate** - Percentage of successful creations
+- **Last Creation** - Timestamp of most recent account
+
+### Account Data Format
+
+Accounts are saved in `data/accounts.json`:
+
+```json
+[
+ {
+ "email": "username@gmail.com",
+ "password": "YourPassword123!",
+ "created_at": "2025-01-14 18:30:43",
+ "status": "active"
+ }
+]
+```
+
+---
+
+## 🔄 Updates & Changelog
+
+### Version 2.0.0 (Current)
+
+**New Features:**
+- ✅ Enhanced phone verification bypass
+- ✅ 5sim API integration
+- ✅ Improved error handling
+- ✅ Better UI/UX
+- ✅ More robust element detection
+- ✅ Separated configuration files
+- ✅ Organized project structure
+- ✅ Beautiful modern interface
+- ✅ Real-time progress tracking
+- ✅ Statistics dashboard
+
+**Improvements:**
+- 🚀 Faster account creation
+- 🛡️ Better anti-detection
+- 🔒 Enhanced security
+- 📊 Better statistics
+- 🎨 Improved UI
+
+**Bug Fixes:**
+- 🐛 Fixed element detection issues
+- 🐛 Fixed password entry problems
+- 🐛 Fixed phone verification handling
+- 🐛 Fixed browser initialization errors
+
+---
+
+## 🌟 Star History
+
+If you find this project useful, please consider giving it a star ⭐ on GitHub!
+
+---
+
+## 🙏 Acknowledgments
+
+- **Selenium** - For web automation capabilities
+- **Rich** - For beautiful terminal UI
+- **5sim** - For phone verification services
+- **All Contributors** - For their valuable contributions
+
+---
+
+
+
+**Made with ❤️ by SHADOWHACKER**
+
+
+
+**© 2025 Shadow Hacker - All Rights Reserved**
+
+[Website](https://www.shadowhackr.com) • [Facebook](https://www.facebook.com/ShadowHackr) • [WhatsApp](https://wa.me/962796668987)
+
+---
+
+⭐ **If you like this project, give it a star!** ⭐
+
+
diff --git a/config/5sim_config.example.txt b/config/5sim_config.example.txt
new file mode 100644
index 0000000..6a8773b
--- /dev/null
+++ b/config/5sim_config.example.txt
@@ -0,0 +1,3 @@
+# Copy this file to config/5sim_config.txt and replace the value below.
+# Do not commit your real API key.
+YOUR_5SIM_API_KEY_HERE
diff --git a/config/5sim_config.txt b/config/5sim_config.txt
deleted file mode 100644
index 6e21d42..0000000
--- a/config/5sim_config.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-YOUR_5SIM_API_KEY_HERE
-
diff --git a/config/README.txt b/config/README.txt
index 8c211ee..a0c418f 100644
--- a/config/README.txt
+++ b/config/README.txt
@@ -2,14 +2,14 @@
📁 Configuration Directory
═══════════════════════════════════════════════════════════════
-This folder contains all sensitive configuration files:
+This folder contains configuration templates and local-only sensitive files:
📄 config.py - General settings
-📄 password.txt - Account password
-📄 5sim_config.txt - 5sim API key
+📄 password.example.txt - Template for local password.txt
+📄 5sim_config.example.txt - Template for local 5sim_config.txt
📄 user_agents.txt - User agents list
-⚠️ Important: These files are NOT obfuscated and can be edited after obfuscation!
+⚠️ Important: Copy the example files to password.txt and 5sim_config.txt locally. Real secrets are ignored by git and should never be committed.
═══════════════════════════════════════════════════════════════
diff --git a/config/password.example.txt b/config/password.example.txt
new file mode 100644
index 0000000..370a9b8
--- /dev/null
+++ b/config/password.example.txt
@@ -0,0 +1,3 @@
+# Copy this file to config/password.txt and replace the value below.
+# Do not commit your real password file.
+YourStrongPassword123!
diff --git a/config/password.txt b/config/password.txt
deleted file mode 100644
index a4df9d5..0000000
--- a/config/password.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-ShadowHacker##$$%%^^&&
-