rroemhild / lavatar

LDAP-backend avatar server

Lavatar

Lavatar is an LDAP-backend avatar server with Gravatar like URL support.

Lavatar fetches all email addresses from an LDAP server with a given search filter and stores them with their md5hash on Redis. Per defualt Lavatar also use Redis to cache the avatar images.

For now lavatar only support image requests.

Quick start

You can use the docker container image and the docker-compose example to test this app:

wget https://raw.githubusercontent.com/rroemhild/lavatar/master/docker-compose.yml
docker-compose up

and test in browser: http://localhost:5000/avatar/982391f62e589420d9fdb56a62c5e16c

Install

git clone https://github.com/rroemhild/lavatar.git
cd lavatar
pip install -r requirements.txt gevent
cp lavatar/default_settings.py settings.py

Configure lavatar in settings.py and run python production.py example.

Image Request

The default image size for the base request is 80x80, max size limit is 1024x1024.

http://localhost:5000/avatar/HASH

Set s or size to scale the avatar image

http://localhost:5000/avatar/HASH?s=160

Set d or default for the default image available in static/img.

http://localhost:5000/avatar/HASH?d=keyword

Set m or method to resize Image with the specified method: 'crop', 'cover', 'contain', 'width', 'height' or 'thumbnail'. Default is thumbnail

http://localhost:5000/avatar/HASH?s=120&m=cover

Set w or width to resize width and h or height to resize height.

http://localhost:5000/avatar/HASH?h=120&m=height