Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/laurentpayot/minidenticons-elm
Super lightweight SVG identicon (icon avatar) generator for Elm
https://github.com/laurentpayot/minidenticons-elm
avatar avatar-component avatar-generator avatars elm identicon identicon-avatar identicon-generator identicon-generators identicon-github identicon-library identicon-svgs identicons light lightweight svg svg-icons tiny
Last synced: 2 days ago
JSON representation
Super lightweight SVG identicon (icon avatar) generator for Elm
- Host: GitHub
- URL: https://github.com/laurentpayot/minidenticons-elm
- Owner: laurentpayot
- License: bsd-3-clause
- Created: 2022-02-11T09:30:07.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-03-04T07:26:29.000Z (over 2 years ago)
- Last Synced: 2023-08-08T20:39:31.562Z (over 1 year ago)
- Topics: avatar, avatar-component, avatar-generator, avatars, elm, identicon, identicon-avatar, identicon-generator, identicon-generators, identicon-github, identicon-library, identicon-svgs, identicons, light, lightweight, svg, svg-icons, tiny
- Language: Elm
- Homepage: https://package.elm-lang.org/packages/laurentpayot/minidenticons-elm/latest
- Size: 227 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Minidenticons
Super lightweight SVG identicon generator.
[](https://github.com/laurentpayot/minidenticons-elm/blob/main/elm.json)
[](https://github.com/laurentpayot/minidenticons-elm/blob/main/elm.json)
[](https://github.com/laurentpayot/minidenticons-elm/blob/main/LICENSE)
## Why
Generate identicons (pixelated avatars) on the client from usernames instead of fetching images from a server!
## Live Demo 🎮
Play with the JavaScript version of Minidenticons [here](https://laurentpayot.github.io/minidenticons/).
## Collisions
You will always get the same identicon for a given username. But it is not impossible to have different usernames with the same identicon. That's a [collision](https://en.wikipedia.org/wiki/Hash_collision).
Generated identicons are 5×5 pixels large with vertical symmetry, and can have 18 different hues for the same saturation and lightness.
This means there are 2⁽³˟⁵⁾ × 18 = 589,824 different identicons possible, but actually much less because of the modulo-based algorithm used to get more colored pixels at the center of the identicon instead of having them scattered. So duplicate identicons are inevitable when using a lot of them. It shouldn’t matter as identicons should not be used solely to identify an user, and should always be coupled to a *unique* username 😉
Tests results below show that you have roughly a 7% chance to generate a duplicate identicon when already using 1000 of them.
```text
0 collisions out of 100 (0.00%)
0 collisions out of 200 (0.00%)
2 collisions out of 300 (0.67%)
6 collisions out of 400 (1.50%)
11 collisions out of 500 (2.20%)
21 collisions out of 600 (3.50%)
38 collisions out of 700 (5.43%)
49 collisions out of 800 (6.13%)
55 collisions out of 900 (6.11%)
66 collisions out of 1000 (6.60%)
296 collisions out of 2000 (14.80%)
589 collisions out of 3000 (19.63%)
962 collisions out of 4000 (24.05%)
1441 collisions out of 5000 (28.82%)
1965 collisions out of 6000 (32.75%)
2564 collisions out of 7000 (36.63%)
3173 collisions out of 8000 (39.66%)
3860 collisions out of 9000 (42.89%)
4570 collisions out of 10000 (45.70%)
```
## License
[BSD 3-Clause](https://github.com/laurentpayot/minidenticons-elm/blob/main/LICENSE)
## Stargazers :heart:
[](https://github.com/laurentpayot/minidenticons-elm/stargazers)