arokettu/monsterid

MonsterID is a method to generate a unique monster image based upon a certain identifier (IP address, email address, whatever). It can be used to automatically provide personal avatar images in blog comments or other community services.

4.0.0 2024-01-03 01:03 UTC

This package is auto-updated.

Last update: 2024-12-13 01:11:42 UTC


README

Packagist PHP license Gitlab pipeline status Codecov

MonsterID is a method to generate a unique monster image based upon a certain identifier (IP address, email address, whatever). It can be used to automatically provide personal avatar images in blog comments or other community services.

Monster Example

MonsterID was inspired by a post by Don Park and the Combinatoric Critters.

Installation

Install it with Composer

composer require 'arokettu/monsterid'

Usage

<?php

use function Arokettu\MonsterID\build_monster;

header('Content-type: image/png');
echo build_monster('sandfox@sandfox.me', 150);

Read full documentation here: https://sandfox.dev/php/monsterid.html

Also on Read the Docs: https://monsterid.readthedocs.io/

License

All graphics were created by Andreas Gohr. The source code and the graphics are provided under the MIT License.

Upgraded and maintained by Anton "Sand Fox" Smirnov.

Original implementation can be found here.