konradmichalik/typo3-letter-avatar

TYPO3 extension, which generates colorful backend user avatars using name initials letter.

2.0.1 2026-04-30 13:12 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• ext-mbstring: *
• symfony/console: ^7.0 || ^8.0
• typo3/cms-backend: ^13.4 || ^14.0
• typo3/cms-core: ^13.4 || ^14.0
• typo3fluid/fluid: ^4.2 || ^5.0

Requires (Dev)

• eliashaeussler/version-bumper: ^3.1.1
• helhum/typo3-console: ^8.3.1
• phpunit/phpunit: ^11.0 || ^12.0
• symfony/translation: ^7.0 || ^8.0
• typo3/cms-base-distribution: ^13.4 || ^14.0
• typo3/cms-lowlevel: ^13.4 || ^14.0

Suggests

• ext-gd: Image processing library for avatar generation
• ext-gmagick: Image processing library for avatar generation
• ext-imagick: Image processing library for avatar generation

GPL-2.0-or-later

• Konrad Michalik

README

TYPO3 extension typo3_letter_avatar

This TYPO3 extension generates colorful backend user avatars using name initials letter.

Note

TYPO3's default backend shows the same silhouette for every user without an uploaded avatar — making large user lists hard to scan. This extension generates a colored letter avatar per user automatically: no uploads, no external services, deterministic colors per name.

✨ Features

• Generates out-of-the-box colorful avatars for backend users
• Easily customizable and flexible configuration
• Provides different predefined color modes and themes
• Supports frontend user avatars with an additional viewhelper

🔥 Installation

Requirements

• TYPO3 13.4 LTS or 14.x
• PHP 8.2, 8.3, 8.4, or 8.5

Compatibility

Version	TYPO3	PHP	Status
2.x	13.4 LTS, 14.x	8.2, 8.3, 8.4, 8.5	active
1.x	11.5 LTS, 12.4 LTS, 13.4 LTS	8.1, 8.2, 8.3, 8.4	maintenance (security only)

Composer

composer require konradmichalik/typo3-letter-avatar:^2.0

TER

Download the zip file from TYPO3 extension repository (TER).

Setup

Set up the extension after the installation:

vendor/bin/typo3 extension:setup --extension=typo3_letter_avatar

The extension will automatically generate avatars for all existing backend users.

🧰 Configuration

See Configuration Documentation for detailed setup instructions including:

• Extension settings configuration
• Custom themes and color modes
• Code-based configuration examples

⚡ Usage

See Usage Documentation for comprehensive usage examples including:

• Backend user avatars (automatic)
• Programmatic avatar generation
• Fluid ViewHelper usage
• Console commands
• Event listener customization

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 Credits

This project is highly inspired by similar open source projects like avatar and letter-avatar.

The fonts used in the extension are licensed under SIL Open Font License and Apache License, Version 2.0.

⭐ License

This project is licensed under GNU General Public License 2.0 (or later).