Website image weight audit

What it does

Finds the images most likely to slow a site down, without changing any file.

• Lists size and pixel dimensions of PNG, JPEG, GIF, WebP, AVIF, BMP, ICO and SVG files (no Pillow needed)
• Collects where and how each image is used from img, srcset, CSS url(), og:image and more
• Flags files that are too large, dimensions that are too large, and images more than 2x wider than their img width attribute
• Flags heavy opaque PNGs, animated GIFs, img tags without width/height, unused images and missing images
• Suggests WebP/AVIF conversion, resizing or replacing GIFs with video, with example commands

Output as Markdown, JSON and CSV.

How to use

python scripts/image_weight.py dist --md image-report.md --csv image-report.csv

The agent checks the context of each image and recommends fixes, highest impact first.

Requirements

• Python 3 (standard library only)

Caveats

• Images are never converted, deleted or overwritten.
• Images reported as unused may still be used by JavaScript or other sites; confirm before deleting.
• Actual display size set by CSS is not always known.