avatars/README.md

# Golang port of DiceBear Avatars, which in turn were inspired by 8biticon avatars

![Example images](mosaic.png)

## Build & Run

```shell
# will build the binary into ${BUILDDIR}. The golang compiler is fetched and installed into ${BUILDDIR}
make BUILDDIR=$PWD
# Create a random avatar and write it to /tmp/avatar.svg
$PWD/gitea/bin/avatar my-special-seed-string > /tmp/avatar.svg
# Open SVG file with image viewer
eog /tmp/avatar.svg
```


## Create mosaic with example images using rsvg and imagemagick montage

```shell
make BUILDDIR=$PWD
for i in {1..40} ; do
	$PWD/gitea/bin/avatar my-special-seed-string_$i > /tmp/avatar_$i.svg
	rsvg-convert /tmp/avatar_$i.svg -z 10 -o /tmp/avatar_$i.png
done
montage -tile 10x4 /tmp/avatar_*.png /tmp/mosaic.png
eog /tmp/mosaic.png
```