in2code/alternative

Automatically set alternative texts for images

1.1.0 2025-12-04 15:40 UTC

Requires

• php: 8.2.*
• typo3/cms-core: ^13.4

Requires (Dev)

• helhum/typo3-console: ^8.2
• typo3/cms-backend: ^13.4
• typo3/cms-belog: ^13.4
• typo3/cms-beuser: ^13.4
• typo3/cms-dashboard: ^13.4
• typo3/cms-extbase: ^13.4
• typo3/cms-extensionmanager: ^13.4
• typo3/cms-filelist: ^13.4
• typo3/cms-fluid: ^13.4
• typo3/cms-fluid-styled-content: ^13.4
• typo3/cms-frontend: ^13.4
• typo3/cms-info: ^13.4
• typo3/cms-install: ^13.4
• typo3/cms-lowlevel: ^13.4
• typo3/cms-rte-ckeditor: ^13.4
• typo3/cms-scheduler: ^13.4
• typo3/cms-setup: ^13.4
• typo3/cms-t3editor: ^13.4
• typo3/cms-tstemplate: ^13.4

GPL-2.0-or-later

• Sandra Pohl
• Alexander Kellner

README

Introduction

This TYPO3 extension allows setting alternative texts, title labels and a description for images in a filestorage. This can be done via file list backend module or via command on the CLI.

Example metadata labels from AI:

Example backend integration:

Example CLI command:

Google Gemini

• To use the extension, you need a Google Gemini API key. You can register for one at https://aistudio.google.com/app/api-keys.

Installation

composer req in2code/alternative

After that, you have to set some initial configuration in Extension Manager configuration:

Title	Default value	Description
setAlternative	1	Toggle function: Set a value for alternative text
setTitle	1	Toggle function: Set a value for image title
setDescription	1	Toggle function: Set a value for a description
showButtonInFileList	1	Show or hide button in backend module file list
apiKey	-	Google Gemini API key. You can let this value empty and simply use ENV_VAR "GOOGLE_API_KEY" instead if you want to use CI pipelines for this setting
limitToLanguages	-	If set, limit to this language identifiers only. Use a commaseparated list of numbers

Note: It's recommended to use ENV vars for in2code/alternative instead of saving the API-Key in Extension Manager configuration

GOOGLE_API_KEY=your_api_key_from_google

CLI commands

# Set metadata for all image files in storage 1
./vendor/bin/typo3 alternative:set "1:/"

# Set metadata for all image files in a subfoler in storage 1 (maybe "fileadmin/in2code/folder/")
./vendor/bin/typo3 alternative:set "1:/in2code/folder/"

# Enforce to set metadata for all image files in storage 1
./vendor/bin/typo3 alternative:set "1:/" 1

Changelog and breaking changes

Version	Date	State	Description
1.1.0	2025-12-04	Feature	Add ddev as local environment, prevent syntax error in PHP 8.2
1.0.0	2025-12-03	Task	Initial release of in2code/alternative

Contribution with ddev

This repository provides a DDEV-backed development environment. If DDEV is installed, simply run the following commands to quickly set up a local environment with example usages:

• ddev start
• ddev initialize

Backend Login:

Username: admin
Password: admin

Installation hint:

1. Install ddev before, see: https://ddev.readthedocs.io/en/stable/#installation
2. Install git-lfs before, see: https://git-lfs.github.com/