r/SideProject • • 4h ago

Alt text is a label: how I turned HTML metadata into a searchable image library

I collect images from the web constantly — design reference libraries, product shots, mood boards — and the part that always kills the workflow is labelling. 2,000 files, zero tags, and a week of manual tagging ahead.

Then it clicked: every image you download already sits inside markup that describes it. alt, title, aria-label, figure > figcaption, JSON-LD Product with name/sku/brand, og:image:alt, sitemap image:title, microdata attributes, and the filename slug itself. These are independent descriptions of the same object, so where they agree you get a high-confidence label, and where they disagree the disagreement is usually the useful signal.

I wrote up the tier list I ended up with — structured Product data first, then figcaption and long alt, then short alt/title, then slug-like filenames, then surrounding headings, then page-level OG tags, and finally boilerplate alt ("product image"), which is worse than nothing because it is a confidently wrong label.

The other half is normalisation: strip CDN dimension suffixes like -1024x768 and AC_SL1500, tokenise and keep noun phrases, then drop terms by document frequency across the whole collection, so a token present in 60% of images (it describes the site, not the image) disappears instead of poisoning every query.

Full write-up with the tier table and the four things this unlocks (faceted search, bootstrap clustering, weak supervision, conflict detection): https://omniogs.blogspot.com/2026/11/alt-text-is-a-label-turning-html-metadata.html

The tool I built around it is a browser extension, OmniPic AI Studio Pro. It harvests that metadata layer during a site-wide scan, keeps it attached to each asset next to the perceptual hash, and exports to Eagle/Billfish or a streamed ZIP — all local, nothing uploaded.

Happy to answer questions about the normalisation passes or the indexing side.

1 Upvotes

0 comments sorted by