Skip to content

kyletscheer/squarespace-assets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Squarespace Asset Utility

A secure and efficient web-based tool for batch-downloading all images from your Squarespace media library. Extract all images from your Squarespace site's asset library with advanced filtering and performance controls.

Squarespace Asset Utility Version License

✨ Features

🔄 Batch Download

  • Bulk extraction of all image assets from Squarespace libraries
  • Concurrent downloads with configurable speed control (1-5 workers)
  • Progress tracking with real-time statistics and ETA
  • Automatic deduplication of CDN resolution variants

🎯 Advanced Filtering

  • File type filtering: JPG, JPEG, PNG, WebP

📁 Smart Organization

  • Duplicate handling: Rename duplicates or skip them entirely
  • File System Access API support for modern browsers
  • Fallback download for older browsers

🎨 User Experience

  • Dark/Light theme toggle
  • Responsive design with mobile warnings
  • Interactive step-by-step guide with zoomable screenshots
  • Real-time console logging with copy functionality
  • Progress visualization and cancellation support

🚀 Quick Start

Prerequisites

  • Desktop computer (mobile devices not supported)
  • Google Chrome browser (optimized for best performance)
  • 4-8 GB free RAM for large libraries
  • Sufficient storage space for your media library

Usage Steps

  1. Load Your Library

    • Navigate to your Squarespace site's Asset Library
    • Scroll to the very bottom until all assets finish loading
  2. Inspect & Copy

    • Right-click anywhere on the page
    • Select "Inspect" to open developer tools
    • Find the <body> element in the Elements panel
    • Right-click it and select "Copy → Copy element"
  3. Configure & Download

    • Paste the copied HTML into the input field
    • Choose your download folder
    • Configure filters and speed settings
    • Click "Extract & Download Assets"

⚙️ Configuration Options

File Type Filters

  • All: Download all detected asset types
  • Custom: Select specific file extensions

Download Speed

  • 1 worker: Sequential downloads (safest, slowest)
  • 2-3 workers: Balanced performance
  • 4-5 workers: Maximum speed (requires more RAM)

Duplicate Handling

  • Download All: Rename duplicates (photo.jpg → photo_2.jpg)
  • Skip Duplicates: Ignore files with identical names

🔧 Technical Requirements

Hardware Recommendations

  • RAM: 4-8 GB free system memory
  • Storage: Sufficient space for your full media library
  • Network: Stable internet connection for large downloads

Browser Compatibility

  • Google Chrome (fully optimized)
  • ⚠️ Other Chromium browsers (may work)
  • Firefox, Safari, Edge (not supported)
  • Mobile browsers (explicitly not supported)

Chrome Settings (Fallback Mode)

If folder selection doesn't work:

  1. Go to chrome://settings/downloads
  2. Turn OFF "Ask where to save each file before downloading"

📱 Mobile Warning

⚠️ This utility is designed exclusively for desktop computers. Mobile devices lack the processing power and storage capabilities needed for bulk media downloads. The application will display a warning on mobile devices and may fail to function properly.

📄 License

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


⚠️ Disclaimer: This tool is not officially affiliated with Squarespace. Use at your own risk and ensure you have the rights to download the assets you're accessing.

About

Download Squarespace Assets in bulk

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages