Face Generator

The face generator is a web app that assembles faces from various elements, generating a wide variety of faces. It supports multiple artists!

Learn how to contribute.

2019-08-06 Hex Describe, Face Generator, Text Mapper, and more

If you’re wondering where the discussion regarding Hex Describe, Face Generator, and Text Mapper actually happens, the answer might surprise you: it happens on the Diaspora network!

There, I create new threads every now and then for people who want to talk to me about these applications. They allow people to generate a mini-setting including a map, a key, and NPCs, with but one click, powered by the greatest collection of random tables I know. 😅

I keep creating these threads whenever the previous thread reaches about 100 comments because it starts being unwieldy.

Here’s a list if you want to explore:

You get the idea. 🙂


Add Comment

2019-07-31 Face Generator

A few days ago I was inspired by the idea of swamp gnomes proposed on my Hex Describe thread on Diaspora and I started extending my collection of face elements:


Apparently Diaspora is currently the best place for me to collaborate with people for Hex Describe, Text Mapper and Face Generator. If you feel like joining, just pop into the new thread on Diaspora. If you don’t have an account, I can recommend Pluspora. It’s been working well enough for me.

My current project: trying to get dragon heads into the generator!



Add Comment

2019-05-19 Ettercap Faces

I was talking to ktrey parker again on Diaspora, and they said: “First, I will definitely have to dig up some the face templates, because I definitely want to do some ettercap faces! All eyes and mandibles!”

This morning I was hitting a lull and those words kept coming back to me. I searched for spider face images and felt inspired. Behold the faces of spider people.

Faces of the spider people

I knew this was going to be an alien face so I don’t actually need a lot of material. They all look the same to us, anyway.

I printed the elf template (narrow faces) and started drawing...

A bad scan from a very old scanner

Rotating image, cropping, scaling, and applying the tintenblau palette...

Cleaned up scan

Cutting these up, splitting the one image where I drew both some hair and a mouth, and looking at them using a local installation of the Face Generator, moving some elements around so that they fit better, less overlap, all of that...

And we’re done!

Oh, and making sure there’s at least one single pixel for “extra spiders” otherwise 10% of the spider faces get a nasty scar, haha.


Add Comment

2019-04-15 Rotating projects

Today I added a picture from a previous post to the About page for Face Generator, plus a copy of what it might look if you used the electronic process (in my example, using Procreate on the tablet).

As I was updating the documentation I started wondering... I have so many projects that I’m working on every now and then, with episodes of activity followed by years of silence, it’s amazing I get anything done, and that I’m not burning out. Why is that? I think two elements are key:

  1. The projects are not very popular so unlike the big endeavours we see online, I have slack. I don’t mind the issues not getting worked on, I don’t mind the services being down, and nobody is giving me any shit about it because I only have a small number of users and most people are nice, anyway.
  2. I have no problems giving projects away. I have written a lot of Emacs code over the years. Simple packages, one here, one there, not a lot in comparison to some very prolific writers, but enough for some of them to get lost. When people do come back to me with issues about software I no longer use, I’m open about it. “I’m sorry, I no longer use it. I will apply your fix, if you have one, or I can try and help you understand the problem and then you can fix it, or ideally you’d take over and I’ll be happy to point people your way. Please do!”

Sometimes I get mail regarding one of the projects I no longer maintain, and I sigh with relief as I know, somebody else is going take care of that. 🙂


Add Comment

2018-11-04 New Faces for the Face Generator

Here’s how to create a new collection for the face generator.

First, print some templates.

Second, get a pen and start drawing a sheet of eyes, of eyebrows, of noses, of mouths, of ears, of hair, of chins.

Drawing face elements

Scan them. I use Gimp and there the FileCreateXSaneDevice dialog... menu opens the scanner application. There, I pick Gray and 300 DPI. Then I scan all the stuff I drew.


Next, in Gimp, the processing begins. The first problem is that either the printer or the scanner don’t really get straight lines.

I like to work at 50% zoom...

Use the rotate tool to rotate the image until it looks as straight as possible (shortcut Shift+R). Move the window edges around until you have the opportunity to check whether the lines are in fact straight. In the screenshot below I’m looking at the left edge to verify that the rotation is good.

Rotating the template

Use the crop tool to cut off anything outside the template (shortcut Shift+C).

Got to ImageScale Image.... Scale it to 2250×3000, breaking the link between width and height.

Got to ColorsLevels. In the top bar, move the tiny white triangle to the left until the template is no longer visible in the image. Click the black pipette and then click onto a line that you have drawn such that all your lines are now pitch black.

Using levels to clean up the image

Export your image (shortcut Ctrl+Shift+E).

Cut the image into elements using cutter.pl. It cuts the scan into 5 × 5 images of 450 × 600 pixels each and labels them by row. You’d invoke it as follows: perl helpers/cutter.pl source1.png alex eyes_all nose_all mouth_all hair_all chin_all or perl helpers/cutter.pl source2.png alex eyes_all nose_all mouth_all hair_all ears_all.

In other words: First is the source image, then the artist name, and then you provide the element for every row. If the remaining rows are all the same element, you don’t need to repeat it. Thus, if you’ve drawn a sheet full of eyes, just use perl helpers/cutter.pl source4.png alex eyes_all and you’re good. Make sure you use _all in the filename. That’s how the system knows the face element can be used for all types of faces.

In my case:

perl helpers/cutter.pl alex3-chin-man-2.png alex3 chin_man
perl helpers/cutter.pl alex3-ears-2.png alex3 ears_all
perl helpers/cutter.pl alex3-eyebrows-2.png alex3 face_all
perl helpers/cutter.pl alex3-eyes-2.png alex3 eyes_all
perl helpers/cutter.pl alex3-hair-2.png alex3 hair_man
perl helpers/cutter.pl alex3-mouths-2.png alex3 mouth_all
perl helpers/cutter.pl alex3-noses-2.png alex3 nose_all

And then to write a license file, the README, we should be ready to go, more or less. Let’s see...

Generated Faces

Check it out!


Comments on 2018-11-04 New Faces for the Face Generator


  1. Cleanup images that have some transparency left in them
  2. Draw more!

– Alex Schroeder 2018-11-04 15:59 UTC

Add Comment

2017-03-24 New Faces

A few days ago I started wondering whether there was an efficient way to draw new face elements for my face generator on a tablet. I used the iPad, the Apple Pencil, and Procreate, started a new image based on the empty grid I always use, used a separate layer for every kind of element (one layer each for eyes, nose, ears, mouth, chin, hair, and extra), exported the image as a PSD file, used ImageMagick to get at the separate PNG layers, split the PNG layers into the various tiles, made sure the naming conventions were good to go, and here we are.

A few things to note: no effort at categorisation was made. For now, the generator mixes all the elements even if later the long ears will be used for elves only, for example. It’s just a first stab at things. I also feel that there ought to be no gender differences as far as eyes or mouth are concerned because I’m assuming no makeup (or equal use of makeup, I guess). I’d like to see how far I can get with sticking to just the chin and baldness as far as sexual dimorphism goes. I think it might work even though we’re pretty used to makeup and hairdo these days.

Anyway, this is the first time I’m seeing some random faces assembled from my PSD file. The proportions still seem to be off. What’s wrong with these heads. Too small, too round? Need more hair? Men need stronger jaws? Something is still wrong.

Feel free to use my template and give it a try!

If you do it, I’d love to get your PSD file to add to the web app. And I’m hoping you’re as willing as I am to dedicate it to the public domain. That makes it easier for everybody else to just use the generated faces for their character sheets, booklets, or whatever they’re doing.


Add Comment

2016-01-03 Squid Faces

The Face Generator now generates squid faces, a.k.a. mindflayers... For those of you needing a squid face or two. And as always, the faces generated are dedicated to the public domain.

The things I’m not happy with:

  1. I ran out of ink half way through drawing the elements and since I try to always wash the fountain pen as I change cartridges, the tentacles turned out very light. I tried to correct it in The Gimp but it isn’t perfect.
  2. I discovered that my layout of facial features was sloppy. There’s a big white area where a human nose would be, but I can’t put a nose there. I can’t move the tentacles up because the jaw lines and the lower eye ridges will interfere. Gah! More planning, less enthusiasm, next time.

I’m not sure whether I’m going to spend more time fixing squid faces. I don’t expect to use them all that often. If you find that you really, really need then, contact me and we’ll talk about it. Hope springs eternal, after all.

Squid Faces


Add Comment

2015-12-20 More Faces for the Generator

The Face Generator gets a new artist!

Random Face by Arbust0


Comments on 2015-12-20 More Faces for the Generator

This is just awesome!

– AlexDaniel 2015-12-25 07:45 UTC

And it reminded me that I can just keep adding to my own folder and so I added 25 more hair elements for women to my folder. The face generator keeps growing on me. :)

– Alex Schroeder 2015-12-26 16:14 UTC

Add Comment

2015-10-08 Dwarves

I’m super happy with my dwarven faces!

Have a random dwarf.


Add Comment

2015-09-28 Better

Everything is better! My Face Generator is progressing nicely. I think the galleries for men and women are already pretty good. The entire app is running on Hypnotoad behind Apache/mod_proxy. It’s fast! And I’m going to support multiple artists. Please help me if you can! I’m not great with faces. I have barely drawn any until this project started. I had to read How to Draw a Face on WikiHow, that’s how bad I was!

Here’s how I’m doing it right now. The basic instructions are on GitHub.

First, print a copy of my empty.pdf. If you need a thinner face, take my elf.pdf. If you need a rounder face, take my dwarf.pdf.

If you printed the default file, this is what it would look like:

Download the PDF!

Make sure you don’t scale the image to fit the page. Try to use 100% of the image.

Then you draw 25 images of a particular element: hair, eyes, nose, ears, mouth, chin. 10% of all faces also get an extra element. Good for scars. My experience is that you need around 50 components for every element to provide enough variety – two sheets for each element is what I suggest.

Then you scan it. You should get something like the following:


There are more examples on Flickr.

If you have something like the above your work is done. Send the images to me and I will do the rest!

What does the rest involve? You crop it and resize it to 2250×3000 pixels. My scanner is notoriously bad about these proportions.

I have scripts to extract whatever you draw from the helping lines of your scan. I have three variants ready to go:

  1. The standard reduces the image to a few shades of blue: convert -blur 0x1 +dither -remap tintenblau.png scan1.jpg source1.png
  2. This is good if you draw using a pencil and want to keep that pencil look: convert -blur 0x1 +dither -level 30%,80% scan1.jpg source1.png
  3. This is good if you draw using a pencil and want to have it look like it was inked without going through the trouble of inking it yourself: convert -blur 0x1 +dither -level 50%,80% -grayscale rec709luma scan1.jpg source1.png

I think you need to think about speed. Two sheet per element with six elements means 12 sheets. Save yourself the time of inking! Fiddle with the -level argument instead. The first percentage means that every pixels darker than this much is going to end up black. The second percentage means that every pixel lighter than this much is going to end up white. Raise the first number until you’re happy with the darkness of your image. Lower the second number until the helping lines disappear.

You should end up with something like the following:


Now’s the time to use my cutter script. It splits the image into 25 images of 450 x 600 pixels each. You must tell it the artist (alex), the element (hair, eyes, nose, ears, mouth, chin, extra) and the type (man, woman, elf, dwarf) you want to save it under: perl helpers/cutter.pl source1.png alex eyes_all.

Eventually, you’ll end up with a large number of files.

And that’s it! I commit it to my repository on GitHub and deploy it on my server.

If you’re running the web application, there’s even the possibility to debug faces.

I’m going to link to the debug interface so that you can take a look – but in the end, you won’t be able to save any changes unless you’re the artist of one the collections.

  1. Choose an element to debug
  2. List all the components for this element (in this case, eyes)
  3. Edit one component (in this case, eyes_all_59.png)
  4. When you click any of the zones, you should get an error… :)


Comments on 2015-09-28 Better

Airi Ayame has been adding manga style face elements. Thank you!! :)

Not yet complete, but already recognizable: → Women's gallery by Airi!

– Alex Schroeder 2015-09-28 12:30 UTC

So, if I want to get digital, a single pic with 450*600 pixels, maybe even with a blue palette would be great. I just found a book on my harddrive with some art from early 19th century - So no scanning but copying and pasting... I was worried that it is a little different stylewise, but, hey Manga... :-)

rorschachhamster 2015-09-28 15:56 UTC

I’ve drawn face elements for elves and dwarves and noticed that having a different head shape was essential for me. That’s why the repository now contains elf.pdf and dwarf.pdf.

Another thing I noticed was that having opaque elements is tricky. This is most relevant if you plan on having white or blond hair cover parts of the face. As you’ll be using a lot of white filling, and since white is considered to be transparent, the face will will shine through your hair.

In order to handle this, I have seen two solutions. Perhaps there are more?

  1. Don’t do it – anything that hangs “in front” of the face needs to be inked. This is what I do.
  2. Use some other color to fill areas that should be opaque and white. Use #FFFFFF for the transparent background and use #FEFEFF for the white-looking opaque foreground. This usually involves flood-filling those areas in Gimp or Photoashop and therefore requires well defined, enclosed areas. This is not always easy to achieve and takes a lot of time.
  3. Use colors. I haven’t seen this in actual use but it should work. If you need something light and opaque, use a light color as you draw. A very light blue, or beige, or grey. Just make sure it’s different from the white background and make sure it’s not interspersed whith white pixels. Using a light pencil might leave too many white pixels, for example.
  • - AlexSchroeder 2015-10-07 21:15 UTC

Add Comment



Please make sure you contribute only your own work, or work licensed under the GNU Free Documentation License. Note: in order to facilitate peer review and fight vandalism, we will store your IP number for a number of days. See Privacy Policy for more information. See Info for text formatting rules. You can edit the comment page if you need to fix typos. You can subscribe to new comments by email without leaving a comment.

To save this page you must answer this question:

Please say HELLO.