A Minotar is a global avatar that pulls your head off your Minecraft.net skin, and allows it for use on several thousand sites - anywhere you can embed an image. See some uses below.

Unlike the PayPal API, we keep things nice and simple. For basic usage just provide a username: <img src="https://minotar.net/avatar/clone1018">

You can also set a size. We use pixels and we only need the width. Just add it to the end. <img src="https://minotar.net/avatar/clone1018/100">

And since some services require an extension we've added simple support for it. Just add .png to the end. <img src="https://minotar.net/avatar/clone1018/100.png">

Sometimes you want to display a helm too, that's fine with this endpoint. <img src="https://minotar.net/helm/clone1018/100.png">

You can even use Minotar's API to get a users skin. We're adding more soon! <img src="https://minotar.net/skin/clone1018">

You can also set the browser to download the image by using: https://minotar.net/download/clone1018

Need Steve? Use "char" as the username:

<img src="https://minotar.net/skin/char">

Installation is simple - however it requires an installation of Go. Follow the instructions below for a comprehensive, step by step installation.

$ git clone https://github.com/minotar/minotar
$ cd minotar

$ export GOPATH=`pwd`
$ go get

$ go build

After you run go build, golang should automatically generate you an executable file (named minotar). Executing the file is simple: simply run:

$ ./minotar

There you have it! Go visit your installation at your-ip:9999 to view it in action.

We use a couple of headers to help in understanding how something is served, here they are:

x-requested

• returns: processed
• explain: if Minotar processed your avatar

x-result:

• returns: ok,failed
• explain: ok on successful GET from s3, failed on failed GET from s3

x-timing:

• returns: fetch time, process time, resize time, whole process
• example: 48+0+4=52

Big thanks to lukegb for porting the old version of this script from PHP to Go.