Skip to content

A web scraping tool that creates a masonry image gallery from a URL.

Notifications You must be signed in to change notification settings

ssrahoo/url2gallery

Repository files navigation

url2gallery


🎯 Overview

url2gallery is a web-scraping tool. It accesses a webpage and collects any online hosted file URLs (e.g., https://<selected webpage URL>/image1.jpg) which are then displayed as an image gallery.


🚀 Features

  • ✅ Remote image extraction
  • ✅ Fluid and dynamic image gallery
  • ✅ Interactive and intuitive UI
  • ✅ Light/dark themes

📦 Installation & Usage

git clone https://github.com/ssrahoo/url2gallery.git
  • A web server or a tool that supports PHP is required (e.g., XAMPP).
  • Ensure the project is in the correct path (e.g., C:\xampp\htdocs\url2gallery)
  • Start the web server and open a web browser with the correct URL (e.g., http://localhost/url2gallery).
  • Select a URL from the dropdown and click on the Generate Gallery button. You can customize the dropdown with your own URLs by editing ./php/config.php
  • Note: Different sites may require different scraping methods, and this application is designed to handle that by leveraging fallback logic. To further increase the coverage of supported sites, you can install node.js + puppeteer.
npm init -y
npm install puppeteer
  • That allows url2gallery to use a headless browser which works on 99% of sites.

📸 Screenshots

img/preview1.jpg
Scraping images from https://www.behance.net/.
img/preview2.jpg
Scraping images from https://www.flickr.com/ + dark theme.
img/preview3.jpg
Scraping images from https://www.pexels.com/ (with puppeteer).

🗺️ Roadmap / TODO

Add list of target file extensions to config file

Fully remove image stacking artifacts (currently, wheel and resize events trigger the fix)


🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

About

A web scraping tool that creates a masonry image gallery from a URL.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •