Broken Image Checker

Broken Image Checker is a Python-based tool designed to identify and report broken images on websites. This tool is perfect for web developers, SEO specialists, and content managers who want to ensure their websites are free of broken image links, improving user experience and search engine rankings.

Features

• Scans web pages starting from a given URL.
• Detects broken images and image redirects.
• Generates a detailed CSV report with broken image information.
• Handles rate-limiting (HTTP 429) and respects website policies.

Requirements

• Python 3.7 or higher

Installation

1. Clone the repository using GitHub Desktop:

   • Open GitHub Desktop.
   • Click on File > Clone Repository.
   • Enter the repository URL: https://github.com/ali-han/Broken-Image-Checker.git.
   • Choose a local path and click Clone.

   Alternatively, download the repository as a ZIP file:

   • Go to the repository page on GitHub.
   • Click the Code button and select Download ZIP.
   • Extract the ZIP file to your desired location.

2. Install the required dependencies using pip:

   pip install -r requirements.txt

   If pip3 is required on your system:

   pip3 install -r requirements.txt

Usage

1. Run the script using Python:

   python run.py

   If python3 is required on your system:

   python3 run.py

2. Enter the starting URL when prompted (e.g., https://example.com).

3. To stop the scan at any time, press CTRL+C.

4. The script will crawl the website, check for broken images, and generate a CSV report in the current directory.

Output

• A CSV file named broken_images_<timestamp>.csv will be created in the current directory.
• The CSV file contains the following columns:
  • Page URL
  • Broken Image URL
  • Details

Notes

• This script is for educational purposes only. Use responsibly and respect website policies.
• The developer is not responsible for any misuse of this tool.

License

This project is licensed under the MIT License.