jodersky / identicon   0.4.0

BSD 3-clause "New" or "Revised" License Website GitHub

Standalone implementation of identicons, similar to the ones used on GitHub

Scala versions: 3.x 2.13 2.12 2.11
Scala.js versions: 1.x 0.6
Scala Native versions: 0.4 0.3


A tiny implementation of identicons, similar to the ones used by GitHub for new avatars.

If you are interested in the workings of identicons, check out this excellent blog post by Jussi Judin.


This library is totally self-contained, there are no 3rd party dependencies. It is built and published for Scala on JVM, JS and Native.


  • mill:

  • sbt:

    "io.crashbox" %%% "identicon" % "0.4.0"


// generate identicon for user "admin" in SVG form
identicon.svg("admin") // = <svg width="5" height="5"><rect x="0" y="3" ...

// in base64 data url form
identicon.url("admin") // = data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0...

See the online generator for an interactive preview. The generator is simply a static site that uses the ScalaJS version of this library.