Find file
Fetching contributors…
Cannot retrieve contributors at this time
69 lines (47 sloc) 2.47 KB

Fake Images Please?

When designing websites, you may not have the images you need at first. But you already know the sizes and inserting some placeholders can help you better seeing the layout. Don’t waste your time making dummy images for your mockup or wireframe. is a little tool that generates images with an URL. Choose the size, the colors, even the text. It’s free and open-source.

How to use

You just have to put your image size after our URL. Only the first parameter is mandatory. There are options too, you can pass a text, or change some colors. Colors must be hexadecimal, the first one is the background color. The text can be passed with the text GET variable. Here are some examples you can look at:

<img src="">
<img src="">
<img src="">
<img src="">
<img src="">
<img src="">

Use them directly in an image tag or a CSS background, or whatever you want to.

Change font

There are three bonus fonts you can choose by passing font=lobster, font=bebas, or font=museo in the URL.

Change font size

You can manually change the font size by passing in the URL font_size=12.

Retina mode

Just pass the retina=1 in the URL. Your image will be 2 times bigger.


Colors support transparency (0 - 255) by putting the alpha value after the color itself. Both colors are supported.

<img src=",128/000">
<img src=",128/000,10">

Set up your own instance


  • Python 2.7 or Python 3.3 or Pypy 2.1
  • Python development headers
  • pip
  • A compilation chain (like gcc or else)
  • libfreetype-dev
# First you need to clone the project
$ git clone
# Install all dependencies with pip
$ pip install Flask Pillow
# Run the tests
$ python
# Run the server
$ python
# Open the browser at


Made by Jérôme Mahuet, with love in 2013. Follow @phollow to stay up-to-date with the project, or if you just want to ask something. Feel free to make pull requests.