Skip to content
This repository has been archived by the owner on Nov 22, 2024. It is now read-only.

Latest commit

 

History

History
125 lines (93 loc) · 3.15 KB

README.md

File metadata and controls

125 lines (93 loc) · 3.15 KB
Raw

Proxy Checker Tool

Python

Table of Contents

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