Documentation - Masanto Hotmail Checker

Installation & Startup

1. Download & Setup

Download the application and install dependencies:


# Install required packages

pip install -r requirements.txt

2. Professional Startup Panel

Launch the application using the startup panel:

python start.py

Choose from startup options:

[1] Localhost Only: Private access on your computer
[2] Online Mode: Public access via Cloudflare tunnel
[3] Exit: Close the application

3. Access URLs

After starting, access the application:


• Main Application: http://127.0.0.1:5000

• Admin Panel: http://127.0.0.1:5000/admin

• Online Mode: Auto-generated tunnel URL (if selected)

Quick Start Guide

1. Admin Setup (First Time)

Login to admin panel with default credentials:


Username: admin

Password: admin123

⚠️ Change password immediately after first login!

2. Navigate with Professional Sidebar

Use the sidebar to navigate between sections:

Home: Landing page with features overview
Email Checker: Main validation interface
Features: Detailed feature showcase
Documentation: This guide
About: Information about the tool

3. Prepare Your Email List

Format your email:password combinations, one per line:


example1@hotmail.com:password123

example2@outlook.com:mypassword

example3@live.com:secretpass

3. Configure Settings

• Threads: Set number of concurrent checks (1-50)
• Proxies: Add proxy list for enhanced privacy (optional)
• Delay: Adjust delay between requests if needed

4. Start Checking

Click "Start Checking" and monitor real-time results

API Reference

System Status

GET /api/status

Returns current system status including login requirements and maintenance mode.

Response:


{

  "status": "online",

  "login_required": false,

  "maintenance_mode": false,

  "sessions_active": 3

}

Admin API Endpoints

GET /admin/api/stats

Get admin dashboard statistics

GET /admin/api/users

List all users (admin only)

POST /admin/api/settings

Update system settings

Configuration Guide

Admin Panel Settings

Access the admin panel at /admin to configure:

• Login Required: Toggle whether users must log in to use the checker
• Max Threads: Set maximum concurrent threads (recommended: 20-50)
• Max Combos: Limit maximum number of emails per session
• Maintenance Mode: Enable/disable maintenance mode

User Management

• Create admin and regular user accounts
• Assign roles and permissions
• Monitor user activity through audit logs
• Deactivate accounts when needed

Environment Variables


HOST=0.0.0.0

PORT=5000

DEBUG=False

SECRET_KEY=your-secret-key

DATABASE_PATH=masanto_checker.db

Security Best Practices

Important Security Notes

• Change default admin password immediately after setup
• Use HTTPS in production environments
• Regularly backup your database
• Monitor audit logs for suspicious activity
• Keep the application updated

Password Security

• All passwords are hashed using Werkzeug security
• Minimum password length enforced
• Session timeout after inactivity
• Secure session management

Troubleshooting

Common Issues

Can't access admin panel

Run python update.py and select "Reset Admin Password"

Database errors

Run python setup.py to reinitialize the database

Checking not working

Check if login is required in admin settings and ensure you're logged in

Server won't start

Check if port 5000 is available or change port in configuration

Maintenance Commands

Setup & Installation

python setup.py

Development Server

python dev.py

Production Server

python run.py

Maintenance Tools

python update.py

Support & Resources

Self-Help Tools

• Health check in admin panel
• System diagnostics via update.py
• Database optimization tools
• Backup and restore utilities

Additional Resources

• README.md - Detailed setup guide
• PROJECT_SUMMARY.md - Project overview
• FIXES.md - Recent fixes and changes
• Inline code documentation

📚 Documentation