PHPackages                             zertex/avatar-generator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. zertex/avatar-generator

ActiveLibrary[Utility & Helpers](/categories/utility)

zertex/avatar-generator
=======================

Avatar generator by username, file or url.

1.16(3y ago)104.5k11BSD-3-ClausePHPPHP >=7.0.0

Since Jun 28Pushed 3y ago1 watchersCompare

[ Source](https://github.com/zertex/avatar-generator)[ Packagist](https://packagist.org/packages/zertex/avatar-generator)[ RSS](/packages/zertex-avatar-generator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (1)Versions (6)Used By (1)

Avatar Generator
================

[](#avatar-generator)

Generate avatar for user by his name, file or url.

[![Latest Stable Version](https://camo.githubusercontent.com/e022a24352707e6c03ed8320cd17e2b57bada449e1ba52f50c9b319940e063ea/68747470733a2f2f706f7365722e707567782e6f72672f7a65727465782f6176617461722d67656e657261746f722f762f737461626c652e706e67)](https://packagist.org/packages/zertex/avatar-generator)[![Total Downloads](https://camo.githubusercontent.com/2bdda3fcbc215b668a95ba263667c1cac38015e4bd921f739533e2062fe6a461/68747470733a2f2f706f7365722e707567782e6f72672f7a65727465782f6176617461722d67656e657261746f722f646f776e6c6f6164732e706e67)](https://packagist.org/packages/zertex/avatar-generator)

Features
--------

[](#features)

- Saving to PNG format
- Generate avatar by username
- Generate avatar from file or url (http only)
- Auto select background color by username
- Contrast color for text
- Font face and size customize
- PNG Textures for background

Dependencies
------------

[](#dependencies)

- PHP 7
- PHP GD

Installation
------------

[](#installation)

Install with composer:

```
composer require zertex/avatar-generator
```

or add

```
"zertex/avatar-generator": "*"
```

to the require section of your `composer.json` file.

Configuration
-------------

[](#configuration)

```
$options = AvatarOptions::create()
			->setFont('path to ttf font')
			->setWidth(300)
			->setFontSize(200)
			->setTexturesFolder('path to textures folder')
			->setImagesFolder('path to generated images folder')
			->setImagesUrl('url to images folder')
			->setSalt('random salt');
```

- setFont - Path to TTF font
- setWidth - Width & height avatar image file. Default: 300
- setFontSize - Font size. Default: 200
- setTexturesFolder - Path to textures folder. Used only PNG textures
- setImagesFolder - Path to image folder.
- setImagesUrl - Url for generating complete link to image
- setSalt - Random text for new image file name

Using
-----

[](#using)

Generate avatar image by username

```
$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->username()
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();
```

Generate avatar image from file

```
$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->file('/path/to/file')
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();
```

Generate avatar image from url

```
$image_src = Avatar::init('John Smith', $options, [result file name])
			   ->file('http://your-site.com/image.jpg')
			   ->texture('TEXTURE_NAME')
			   ->text()
			   ->get_file_name();
```

You can exclude texture or text from chain for exclude them

Textures
--------

[](#textures)

You can use PNG texture with transparancy. Every texture must consist of **2 files** (back & white). His names myst be:

```
TEXTURE_NAME . '-' . COLOR . '.png'
```

- TEXTURE\_NAME - Any words. In texture() method you can use array of TEXTURE\_NAME for random
- COLOR - Must be `black` or `white`

Screenshot
----------

[](#screenshot)

[![alt text](https://camo.githubusercontent.com/3504ac92066da9112cec09b0bfa2882dd411a1899c854381826ce65c4bedbd45/687474703a2f2f7a65727465782e72752f6578742d62616e6e65722d61332e706e67)](https://camo.githubusercontent.com/3504ac92066da9112cec09b0bfa2882dd411a1899c854381826ce65c4bedbd45/687474703a2f2f7a65727465782e72752f6578742d62616e6e65722d61332e706e67)

Yii2 extension
--------------

[](#yii2-extension)

Avater generator extension for Yii2 here:

There you can find 2 textures and Play-Bold.ttf font

Examples
--------

[](#examples)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~424 days

Total

5

Last Release

1185d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/23960eb78c22b402a0e26140a49a156c4eba9cccd637067010c7f33524a66f09?d=identicon)[Error202](/maintainers/Error202)

---

Top Contributors

[![zertex](https://avatars.githubusercontent.com/u/6353201?v=4)](https://github.com/zertex "zertex (9 commits)")

---

Tags

avataruserpic

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/zertex-avatar-generator/health.svg)

```
[![Health](https://phpackages.com/badges/zertex-avatar-generator/health.svg)](https://phpackages.com/packages/zertex-avatar-generator)
```

###  Alternatives

[laravolt/avatar

Turn name, email, and any other string into initial-based avatar or gravatar.

2.0k5.4M31](/packages/laravolt-avatar)[yohang88/letter-avatar

Generate user avatar using name initials letter.

126529.5k2](/packages/yohang88-letter-avatar)[tomloprod/radiance

A deterministic mesh gradient avatar generator for PHP.

1393.7k](/packages/tomloprod-radiance)[zertex/yii2-avatar-generator

Avatar generator for Yii2 Framework.

104.5k1](/packages/zertex-yii2-avatar-generator)[astrotomic/laravel-unavatar

Laravel integration of unavatar service.

297.9k](/packages/astrotomic-laravel-unavatar)[splitbrain/php-ringicon

A indenticon/glyphicon like avatar generator

1613.3k1](/packages/splitbrain-php-ringicon)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)