PHPackages                             ianm/boring-avatars - 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 &amp; Helpers](/categories/utility)
4. /
5. ianm/boring-avatars

ActiveFlarum-extension[Utility &amp; Helpers](/categories/utility)

ianm/boring-avatars
===================

Replace default Flarum avatars with Boring Avatars.

1.0.1(1y ago)09.2k↑1750%[2 issues](https://github.com/imorland/flarum-ext-boring-avatars/issues)MITPHPPHP ^8.0CI passing

Since Jan 16Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/imorland/flarum-ext-boring-avatars)[ Packagist](https://packagist.org/packages/ianm/boring-avatars)[ Fund](https://www.buymeacoffee.com/ianm1)[ RSS](/packages/ianm-boring-avatars/feed)WikiDiscussions 2.x Synced 3d ago

READMEChangelog (4)Dependencies (5)Versions (10)Used By (0)

Boring Avatars
==============

[](#boring-avatars)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/4e9403573f78e83245097348588ad1894b118e0dab127a2dbb1f7bfe807618db/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69616e6d2f626f72696e672d617661746172732e737667)](https://packagist.org/packages/ianm/boring-avatars) [![Total Downloads](https://camo.githubusercontent.com/f1bcf550123e32a9c3b2844fd9ea3c342d0e857b6ee774f802a292e2ba5d3e24/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69616e6d2f626f72696e672d617661746172732e737667)](https://packagist.org/packages/ianm/boring-avatars)

A [Flarum](http://flarum.org) extension. Replace default Flarum avatars with Boring Avatars.

About
-----

[](#about)

Utilize generated "Boring Avatars" on your Flarum forum, without compromising your user privacy. It is a PHP port of the [React based Boring Avatars](https://github.com/boringdesigners/boring-avatars)

Features
--------

[](#features)

- Choose from 6 themes + plus an exclusive animated version of the "ring" theme
- Customize the color palette used
- Completely self contained, no external calls are required
- Multiple identifier configuration (Select from ID, username or email address to generate unique avatars)
- SVG avatars, which are directly included in the user object - no additional network requests to retrieve avatars
- Automatically updates the avatar if the identifier changes
- Supports GDPR export, anonymization, deletion

Screenshots
-----------

[](#screenshots)

### Bauhaus

[](#bauhaus)

[![bauhaus](https://private-user-images.githubusercontent.com/16573496/298019594-36db7a2a-43f8-4e54-85c6-0d983e40a3e6.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk1OTQtMzZkYjdhMmEtNDNmOC00ZTU0LTg1YzYtMGQ5ODNlNDBhM2U2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTgxYzAyNDY3Y2RkNjVjYmI4ZjNlYzc5YWU2MmFjOTc0NTNkZTczMGEwOWQ1MjkyMDI3N2NlMDc5MzRjODQ4MmImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.SF8X3T-aFa6n7VrifCZsfDN-sBU78y0OKDgMvYqDntg)](https://private-user-images.githubusercontent.com/16573496/298019594-36db7a2a-43f8-4e54-85c6-0d983e40a3e6.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk1OTQtMzZkYjdhMmEtNDNmOC00ZTU0LTg1YzYtMGQ5ODNlNDBhM2U2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTgxYzAyNDY3Y2RkNjVjYmI4ZjNlYzc5YWU2MmFjOTc0NTNkZTczMGEwOWQ1MjkyMDI3N2NlMDc5MzRjODQ4MmImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.SF8X3T-aFa6n7VrifCZsfDN-sBU78y0OKDgMvYqDntg)

### Beam

[](#beam)

[![beam](https://private-user-images.githubusercontent.com/16573496/298019490-a2716645-2230-426d-af77-6f492485b626.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk0OTAtYTI3MTY2NDUtMjIzMC00MjZkLWFmNzctNmY0OTI0ODViNjI2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThiZmZhZDk4YmRlZTlhZjk2NWNjZWZiNDZiZjMzM2VkNzRjMDc0ZjQ2MzM4OTQ5NGU2MTU2NWMwY2Y3MTEzOWEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.kSbU5reignS2k7UoAuS4pfK1ZtDj8IH1uE9ysCgcBKQ)](https://private-user-images.githubusercontent.com/16573496/298019490-a2716645-2230-426d-af77-6f492485b626.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk0OTAtYTI3MTY2NDUtMjIzMC00MjZkLWFmNzctNmY0OTI0ODViNjI2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThiZmZhZDk4YmRlZTlhZjk2NWNjZWZiNDZiZjMzM2VkNzRjMDc0ZjQ2MzM4OTQ5NGU2MTU2NWMwY2Y3MTEzOWEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.kSbU5reignS2k7UoAuS4pfK1ZtDj8IH1uE9ysCgcBKQ)

### Marble

[](#marble)

[![marble](https://private-user-images.githubusercontent.com/16573496/298019707-00268553-37e0-4b3a-9e80-e9a40ea5681d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk3MDctMDAyNjg1NTMtMzdlMC00YjNhLTllODAtZTlhNDBlYTU2ODFkLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTA1NTY5YzM3ZmM3ZDE4NjZiMGM0NmVlYjQ0ZGM2OWViZTkxZjJhZWYxMmYyNGM5MDQ3MWY2YzY3Njc2M2ZjZjImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.Ag-xaB8Knn5_XPNXmGb8izNOVEXJoDDWzDNzHHPHgcw)](https://private-user-images.githubusercontent.com/16573496/298019707-00268553-37e0-4b3a-9e80-e9a40ea5681d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk3MDctMDAyNjg1NTMtMzdlMC00YjNhLTllODAtZTlhNDBlYTU2ODFkLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTA1NTY5YzM3ZmM3ZDE4NjZiMGM0NmVlYjQ0ZGM2OWViZTkxZjJhZWYxMmYyNGM5MDQ3MWY2YzY3Njc2M2ZjZjImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.Ag-xaB8Knn5_XPNXmGb8izNOVEXJoDDWzDNzHHPHgcw)

### Pixel

[](#pixel)

[![pixel](https://private-user-images.githubusercontent.com/16573496/298019809-042bb78d-50fd-4500-a4a7-fcb1e721133e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk4MDktMDQyYmI3OGQtNTBmZC00NTAwLWE0YTctZmNiMWU3MjExMzNlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTM1MDI0ZmZjZTU1YmI2Nzc3MDgzNjAxODIxYjAwN2Q4Mzc4Yzk2MDUzYWVjMGQ4MjQ4ODhiNWVlZGRjYjE0MDImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.Y9lgtV9DC9jbObyaktlIQfF7O2rHPlnGMdYQZcsX07k)](https://private-user-images.githubusercontent.com/16573496/298019809-042bb78d-50fd-4500-a4a7-fcb1e721133e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk4MDktMDQyYmI3OGQtNTBmZC00NTAwLWE0YTctZmNiMWU3MjExMzNlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTM1MDI0ZmZjZTU1YmI2Nzc3MDgzNjAxODIxYjAwN2Q4Mzc4Yzk2MDUzYWVjMGQ4MjQ4ODhiNWVlZGRjYjE0MDImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.Y9lgtV9DC9jbObyaktlIQfF7O2rHPlnGMdYQZcsX07k)

### Ring

[](#ring)

[![ring](https://private-user-images.githubusercontent.com/16573496/298019929-4840353d-204b-46fc-b6dd-27df2b47d9dc.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk5MjktNDg0MDM1M2QtMjA0Yi00NmZjLWI2ZGQtMjdkZjJiNDdkOWRjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTU0ODIzNDRhN2E2ZDFjZTA4MTg0ZjlkOGE2ZWQzYTdlOTJhNGUyNGNhYTVkOTMzOGFhMGRjY2Y0NmQzNmM2YWQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.0dzFg1UtQZQuZgm9PnoOhl02P6OqVqAtDwpr3usxoB8)](https://private-user-images.githubusercontent.com/16573496/298019929-4840353d-204b-46fc-b6dd-27df2b47d9dc.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMTk5MjktNDg0MDM1M2QtMjA0Yi00NmZjLWI2ZGQtMjdkZjJiNDdkOWRjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTU0ODIzNDRhN2E2ZDFjZTA4MTg0ZjlkOGE2ZWQzYTdlOTJhNGUyNGNhYTVkOTMzOGFhMGRjY2Y0NmQzNmM2YWQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.0dzFg1UtQZQuZgm9PnoOhl02P6OqVqAtDwpr3usxoB8)

### Sunset

[](#sunset)

[![sunset](https://private-user-images.githubusercontent.com/16573496/298020043-4554b185-ecc2-4185-93cf-75c426baad5f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMjAwNDMtNDU1NGIxODUtZWNjMi00MTg1LTkzY2YtNzVjNDI2YmFhZDVmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTY3Zjc1Y2Y0ZjhmNzM5ZjM4MzU4NzEyNTI0ZDM0OWVkZTE3YjJjYTMyOTQwNWY3Y2Y4Y2Y0ZTE5OGQ0MDE3M2ImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.3FvNkitEB0bMwasbWZtnnK5AItleYs_4By1oXGqK_wo)](https://private-user-images.githubusercontent.com/16573496/298020043-4554b185-ecc2-4185-93cf-75c426baad5f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMjAwNDMtNDU1NGIxODUtZWNjMi00MTg1LTkzY2YtNzVjNDI2YmFhZDVmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTY3Zjc1Y2Y0ZjhmNzM5ZjM4MzU4NzEyNTI0ZDM0OWVkZTE3YjJjYTMyOTQwNWY3Y2Y4Y2Y0ZTE5OGQ0MDE3M2ImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.3FvNkitEB0bMwasbWZtnnK5AItleYs_4By1oXGqK_wo)

### Settings

[](#settings)

[![settings](https://private-user-images.githubusercontent.com/16573496/298020148-05b70f55-31f0-4aee-852a-6344ae37630f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMjAxNDgtMDViNzBmNTUtMzFmMC00YWVlLTg1MmEtNjM0NGFlMzc2MzBmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTMxMGEzZmI1YzcyNWIxYWM0NWU0YWRjMTVmMzdmMmJmNWNiNGQ5YzIyYTQzYmU2MWE4YjkzYTdhM2I1OTk4YTcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.-iJeXi___RpRgZj7LfQNHlWAgd8ITtNtYAYOmLITiOo)](https://private-user-images.githubusercontent.com/16573496/298020148-05b70f55-31f0-4aee-852a-6344ae37630f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MTIwNTksIm5iZiI6MTc4MjcxMTc1OSwicGF0aCI6Ii8xNjU3MzQ5Ni8yOTgwMjAxNDgtMDViNzBmNTUtMzFmMC00YWVlLTg1MmEtNjM0NGFlMzc2MzBmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA1NDIzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTMxMGEzZmI1YzcyNWIxYWM0NWU0YWRjMTVmMzdmMmJmNWNiNGQ5YzIyYTQzYmU2MWE4YjkzYTdhM2I1OTk4YTcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.-iJeXi___RpRgZj7LfQNHlWAgd8ITtNtYAYOmLITiOo)

Usage
-----

[](#usage)

After enabling, select **Boring Avatars** as the avatar driver under **Admin → Basics → Avatar Driver**. Avatars are generated on first view and cached automatically, so no background jobs or queue setup is required.

Changing any setting (theme, colors, identifier) will clear all cached avatars, and they will be regenerated as users are next viewed.

To eagerly pre-generate avatars for all users, run:

```
php flarum boringavatars:generate
```

Use `--force` to regenerate avatars for users who already have one.

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

[](#installation)

Install with composer:

```
composer require ianm/boring-avatars:"*"
```

Updating
--------

[](#updating)

```
composer update ianm/boring-avatars:"*"
php flarum migrate
php flarum cache:clear
```

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/ianm/boring-avatars)
- [GitHub](https://github.com/ianm/boring-avatars)
- [Discuss](https://discuss.flarum.org/d/33989)
- [Extension Icon](https://source.boringavatars.com/beam/30/Flarum%20Boring%20Avatar?square)

Support
-------

[](#support)

Please consider supporting my extension development and maintenance work.

[![Buy Me A Coffee](https://camo.githubusercontent.com/9a769e616ce78645bf51d12e4179cfbfd72fb413722b284e0be3ec3c75a86010/68747470733a2f2f63646e2e6275796d6561636f666665652e636f6d2f627574746f6e732f64656661756c742d6f72616e67652e706e67)](https://www.buymeacoffee.com/ianm1)

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance62

Regular maintenance activity

Popularity24

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75.6% 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 ~90 days

Recently: every ~131 days

Total

10

Last Release

84d ago

Major Versions

1.x-dev → 2.0.0-beta.12025-11-02

PHP version history (2 changes)1.0.0-beta.1PHP ^8.0

2.0.0-beta.1PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16573496?v=4)[IanM](/maintainers/imorland)[@imorland](https://github.com/imorland)

---

Top Contributors

[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (31 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (7 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (3 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/ianm-boring-avatars/health.svg)

```
[![Health](https://phpackages.com/badges/ianm-boring-avatars/health.svg)](https://phpackages.com/packages/ianm-boring-avatars)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

191192.5k18](/packages/fof-upload)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in &amp; sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)

PHPackages © 2026

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