modula-gallery-extractor

Download images from a Modula WordPress gallery page into a folder and a .zip.

The extractor looks for Modula thumbnails and uses the full-resolution image URL from the data-full attribute (example below).

<img
  class="pic"
  data-full="https://example.com/wp-content/uploads/2021/09/DSC00556.jpg"
  src="https://example.com/wp-content/uploads/2021/09/DSC00556-200x300.jpg"
/>

Install (recommended: uv)

From the repo root:

uv sync

Run the CLI:

uv run modula-gallery-extractor "https://domain.com/galery-2021/"

Usage

uv run modula-gallery-extractor URL `
  --output .\downloads `
  --max-concurrency 12 `
  --timeout-seconds 120 `
  --retries 3

Output

For a page like .../galery-2021/, you’ll get:

• downloads/galery-2021/ (images)
• downloads/galery-2021.zip

Notes

• Pages can be slow to respond; the tool uses a long default timeout and retries.
• If the page contains multiple galleries, this tool currently downloads all Modula images on that page into a single folder.

Dev

uv run ruff check .
uv run pytest

Legal

Use only on content you own or are allowed to download.