Proxy Checker Tool

Table of Contents

• Introduction
• Features
• Installation
• Usage
• Examples
• Contributing
• License

Introduction

The Proxy Checker Tool is designed to help you validate proxy servers. It allows you to check proxies from a file or a single proxy URL and determines its status and latency. This tool also provides a convenient way to interrupt the process if needed.

Features

• Validate proxy servers.
• Support for different proxy types (http, https, socks4, socks5).
• Calculate and display latency of each proxy.
• User-friendly interruption by pressing 'q'.
• Color-coded output for easy status identification.

Installation

To install this tool, you need to have Python 3.8 or above installed on your machine. Then, follow these steps:

1. Clone this repository:

   https://github.com/AmaniToamaWebDevelp1/proxychecker.git
   cd proxychecker

2. Install the required packages:

   pip install -r requirements.txt

3. Install using apt for Linux:

   sudo apt update
   sudo apt install proxychecker

Usage

Command-line Arguments

• -t, --txt: Path to a text file containing proxy URLs, one per line.
• -s, --single: A single proxy URL to be checked immediately.
• -p, --protocol: Protocol to use with the single proxy (e.g., socks4), if not specified, it will be auto-detected.
• -u, --url: URL retrieve data as a text contains proxies per one line.

Running the Tool

Check proxies from a file:

python proxychecker.py -t path/to/proxyfile.txt

Check proxies from URL:

python proxychecker.py -u https://raw.githubusercontent.com/TheSpeedX/SOCKS-List/master/socks4.txt

Check a single proxy:

python proxychecker.py -s http://103.162.184.251:1088

Check a single proxy with a specified protocol:

python proxychecker.py -s 20.205.61.143:8123 -p socks5

Interrupting the Process

While checking proxies from a file, you can interrupt the process by pressing 'q' and then [Enter].

Examples

Checking proxies from a file:

python proxychecker.py -t proxies.txt

Checking a single HTTP proxy:

python proxychecker.py -s http://103.162.184.251:1088

Checking a single proxy with auto-detection to protocol:

python proxychecker.py -s 20.205.61.143:8123 -p none

python proxychecker.py -s 20.205.61.143:8123 

Checking a single proxy with a specified protocol:

python proxychecker.py -s 20.205.61.143:8123 -p socks5

python proxychecker.py -s socks5://20.205.61.143:8123 

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix (git checkout -b feature-name).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature-name).
5. Open a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Developed with ❤️ by Amani Toama