🌍 Offline Global Mobile Number Validator

Bulk mobile number validator built with Python.
Fully offline, fast, multiprocessing-enabled, and exports per-country results.

---

🚀 Features

• ✅ Fully offline (no API required)
• ✅ Global phone number support
• ✅ Simple Tkinter file picker GUI
• ✅ Multiprocessing (uses all CPU cores)
• ✅ Live progress bar
• ✅ Per-country export (CSV + TXT)
• ✅ Invalid numbers saved separately
• ✅ Carrier and location detection

---

📦 Requirements

• Python 3.8+
• phonenumbers
• tqdm

Install dependencies:

pip install phonenumbers tqdm

---

📂 Input Format

Provide a .txt file containing one number per line:

+14155552671
447911123456
919876543210

Numbers may include spaces or symbols — they will be cleaned automatically.

---

▶️ How to Run

python bulk_global_number_validator.py

1. A file selection window will open.
2. Select your .txt file containing numbers.
3. The script validates all numbers using multiprocessing.
4. Results are exported automatically.

---

📁 Output Structure

A folder named:

validated_results/

Will be created in the same directory as your input file.

Per-Country Valid Files

Examples:

• US_valid.csv
• US_valid.txt
• IN_valid.csv
• IN_valid.txt

Invalid Numbers File

invalid.txt

---

📊 CSV Output Fields

Each CSV file contains:

• input
• e164
• national
• country_code
• region
• carrier
• location
• number_type
• is_possible
• is_valid

---

💡 Use Cases

• Lead list cleaning
• SMS campaign preparation
• International database validation
• Telecom data processing
• Bulk number verification

---

🛡️ Privacy

This tool works completely offline.
No data is sent to external servers.

---

📜 License

MIT License