README

Write SEO-friendly alt text for the images in your TYPO3 file list. Generate it for one image, for a selection or for every image that is missing it, review it, and save. 131 languages.

Get a free API key

What you get

A bulk module. Alt Text Generator AI sits next to the file list (File in TYPO3 13, Media in TYPO3 14). It lists your images with a preview, shows the ones with no alt text, and writes it for all of them or only the ones you tick.
Review before saving. Edit any text, then save everything at once. The text goes into the Alternative field of the file's metadata, which TYPO3 uses as the alt attribute of the image.
Your site languages. Choose the language of the text and the TYPO3 site language it is saved for.
131 languages for the text, including English, Spanish, French, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Arabic and Hindi.
Credits shown in the module. One credit writes alt text for one image. New accounts get free credits.
Your key stays on your server. The API key is only used by TYPO3's PHP code and never reaches the browser.

Requirements

TYPO3 13.4 LTS or 14 LTS
PHP 8.2 or newer
An Alt Text Generator API key (get one free)

Install

With Composer:

composer require balt1794/alt-text-generator-ai
vendor/bin/typo3 extension:setup

Without Composer, download the ZIP from the releases page, upload it in Admin Tools > Extensions and activate it.

Then open the module, paste your API key and click Save key. Only administrators can change the key.

Use it

Open Alt Text Generator AI in the file section. It lists your images and shows your credits. Click Scan images if you added files outside the file list, for example over FTP.
Missing shows the images with no alt text for the chosen site language. All shows everything.
Tick the images you want, or leave them all unticked.
Click Generate selected or Generate all missing. Each image uses 1 credit.
Read the results, change anything you like, then click Save changes.

Generate all missing skips images that already have alt text. Tick an image to generate it anyway, or tick Overwrite images that already have alt text.

Good to know

Images are shrunk to 1024 px on the long side before they are sent.
Editors who are not administrators can generate and save when their user group may edit file metadata.
To set the key in a deployment, use Admin Tools > Settings > Extension Configuration > alt_text_generator_ai. A key saved in the module takes priority.

Development

composer install
vendor/bin/phpunit

License

GPL-2.0-or-later. See LICENSE.

balt1794 / alt-text-generator-ai

Package info

Security

Statistics