Ed Southwood · South West

Case study · Photos → text

Accessibility text for 1,392 images, overnight

A collection of engineering-maths workbooks — 186 sections, thousands of diagrams — needed a written description for every image so that screen-reader users could follow them. Doing it by hand is months of work. A script did it while I slept.

Images processed 1,392 Skipped as already done 7,229 Where it ran locally (no data sent out) or cloud, switchable Presented at CETL-MSOR 2026 conference

The problem

Accessibility law and common decency both say images on a website need a text description. For a textbook full of graphs, circuit diagrams and geometric figures, that's a lot of careful writing, and it never gets to the top of anyone's list. The collection had sat without descriptions for years.

What I built

A program that walks through every web page in the collection, finds each image, converts it to a format the AI can see, and sends it — with the surrounding text for context — to a vision-capable AI model. The model writes a one-sentence description for the image tag and a longer, structured description on a linked page. The script records its progress in a log so it can be stopped and resumed, and skips anything already done.

Crucially, it can use a model running on a machine in the room rather than a cloud service. For this job nothing needed to leave the building. The same switch lets it use a cloud model where quality matters more than privacy.

What changed

  • 1,392 images described in a run that would otherwise have taken a person months.
  • A repeatable process: when a page changes, re-run it and only the new images are done.
  • A generic version of the script that works on any folder of web pages, packaged and shared with other institutions after the conference talk.

Time and cost

A few days to build and check. Running on a local model, the cost was electricity. Using a cloud model instead would have been in the tens of pounds for the whole collection.

What this could mean for your business

  • Online shops and marketplaces: consistent product descriptions and alt text from a folder of photos, in your tone of voice, in bulk.
  • Estate and letting agents: room-by-room descriptions from listing photos.
  • Any website: meet accessibility requirements without a rewrite. Public bodies and anyone selling to them will increasingly ask for this.
  • Anyone with photos of jobs: before/after write-ups for your website and social media from the pictures your team already takes.

Got something similar? Book a free 30-minute chat and describe it. If it's a one- or two-day build, I'll quote a fixed price on the spot.

← All case studies