Skip to content

Latest commit

 

History

History
292 lines (246 loc) · 11.4 KB

README.md

File metadata and controls

292 lines (246 loc) · 11.4 KB

🔥 Proxy Checker and Generator 🚀

A multithreaded Python Proxy Checker and Generator featuring strict IP matching, geolocation fallback, UTF-8-safe handling, and an instant stop function that truly halts all background tasks in real time.

Python License

✨ Overview

This Proxy Checker and Generator is a multithreaded Python application that combines:

  • Proxy Generation: Random public IPv4 generation with appropriate proxy ports.
  • Proxy Checking: Ensures proxies are valid with strict IP matching and multiple test endpoints.
  • Geolocation Fallback: Uses multiple APIs (ip-api.com, geojs.io, ipwhois.io, ipapi.co) for reliable IP location.
  • UTF-8 Safe: Avoids utf-8 codec errors during file operations by ignoring invalid bytes.
  • Immediate Stop: Truly halts proxy generation and validation instantly—no lingering background processes.
  • Multi-Protocol Support: Validates HTTP, HTTPS, SOCKS4, and SOCKS5 proxies.
  • Customizable Settings: Adjust retries, concurrency, timeouts, and more.

🎉 Features

  1. Strict IP Validation
    Proxies are marked valid only if the target test service sees the proxy's IP.
    ➡️ Eliminates false positives for SEO-friendly proxy validation.

  2. Proxy Generator
    Generates random IPv4 addresses within realistic public ranges, appending commonly used proxy ports.

  3. Immediate Stop Functionality
    The Stop button halts all generation and validation tasks instantly.
    ➡️ No more lingering logs or tasks in the background.

  4. Geolocation Fallback
    Utilizes multiple APIs for reliable IP geolocation, automatically switching to the next API if rate-limited.

  5. UTF-8 Safe File Handling
    Validated proxies are saved to files without causing codec errors—ensures smooth analytics workflows.

  6. Modern, Simple GUI

    • Clear tabs for Checker, Generator, Settings, and About.
    • Real-time logs and progress updates.
    • Clean, dark-themed interface for a polished look.

  7. Advanced Customization

    • Configurable retries (set 0 for single attempt).
    • Adjustable concurrency and timeout per check.
    • Proxy protocols toggled with a single click.

  8. Export Options
    Save valid proxies to text, CSV, or JSON—or copy to clipboard directly.

🛠️ Installation

  1. Clone or Download this repository:

    git clone https://github.com/kubaam/Proxy-Checker-and-Generator.git
cd Proxy-Checker-and-Generator.git

  2. Install Dependencies:

    pip install -r requirements.txt

    Ensure Python 3.9+ is installed.

  3. Run the Application:

    python main.py

⚙️ Usage

  1. Generate Proxies:
    Select protocols (HTTP, HTTPS, SOCKS4, SOCKS5) and click Start. The app will generate and check proxies simultaneously.

  2. Load Proxy List:
    Load a list of proxies from a file to validate existing proxies. Format:

    protocol://IP:Port

  3. Settings:
    Adjust retries, timeout, concurrency, and other preferences in the Settings tab.

  4. Export Results:
    Save validated proxies to:

    • .txt: Simple IP:Port format.
    • .csv: Includes status, geolocation, and response time.
    • .json: Full structured data.

⚡ Key Benefits for SEO

  • Accurate Proxy Validation: Ensures only working, reliable proxies pass validation.
  • High Throughput: Multithreaded design handles large lists effortlessly.
  • Geolocation Fallback: Reliable for regional proxy needs.
  • Immediate Stop: Total control over ongoing processes.

🤝 Contributions

We welcome improvements, bug fixes, or feature requests!

  1. Fork this repository.
  2. Create a new branch (feature/amazing-feature).
  3. Commit your changes.
  4. Open a pull request.

📜 License

Licensed under the MIT License. See LICENSE for details.

Support and Contributions 🤝

Feel free to contribute or report bugs via GitHub. Pull requests are welcome!
If you appreciate this tool, you can support its development by donating here:
PayPal - Jakub Ambrus

Happy Proxy Checking & Generating! 🌐