Avatar generator library for GO language
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 3 commits ahead of o1egl:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bindata
data
files
govatar
.gitignore
.travis.yml
LICENSE
Makefile
README.md
govatar.go
govatar_test.go
utils.go
utils_test.go

README.md

GOvatar

License GoDoc Build Status Coverage Status Go Report Card

GOvatar image

GOvatar is an avatar generation library writen in GO

Install

To install the library and command line program, use the following:

$ go get -u github.com/o1egl/govatar/...

Binary packages are available for Mac, Linux and Windows.

Usage

    $ govatar generate male -o avatar.png                        # Generates random avatar.png for male
    $ govatar generate female -o avatar.png                      # Generates random avatar.png for female
    $ govatar generate male -u username@site.com -o avatar.png   # Generates avatar.png for specified username
    $ govatar -h                                                 # Display help message

As lib

Generates avatar and save it to filePath

    err := govatar.GenerateFile(govatar.MALE, "/path/to/avatar.jpg"
    err := govatar.GenerateFileFromUsername(govatar.MALE, "username", "/path/to/avatar.jpg")

Generates avatar and return it as image.Image

    img, err := govatar.Generate(govatar.MALE)
    img, err := govatar.GenerateFromUsername(govatar.MALE, "username")

Copyright, License & Contributors

Adding new skins

  1. Add new skins to background, male/clothes, female/hair and etc...
  2. Run $ make assets for building embedded assets.
  3. Submit pull request :)

Submitting a Pull Request

  1. Fork it.
  2. Create a branch (git checkout -b my_branch)
  3. Commit your changes (git commit -am "Added new awesome avatars")
  4. Push to the branch (git push origin my_branch)
  5. Open a Pull Request
  6. Enjoy a refreshing Diet Coke and wait

GOvatar is released under the MIT license. See LICENSE