Skip to content
Bernardo Heynemann edited this page Oct 18, 2013 · 57 revisions

Thumbor Imaging Service

PyPi version PyPi downloads

Thumbor is a smart imaging service. It enables on-demand crop, resizing and flipping of images.

It also features a VERY smart detection of important points in the image for better cropping and resizing, using state-of-the-art face and feature detection algorithms (more on that in Detection Algorithms).

Using thumbor is very easy (after it is running). All you have to do is access it using an URL for an image, like this:

http://thumbor-server/unsafe/300x200/smart/s.glbimg.com/et/bb/f/original/2011/03/24/VN0JiwzmOw0b0lg.jpg

That URL would show an image of the big brother brasil participants in 300x200 using smart crop. There are several other options to the image URL configuration. You can check them in the Usage page. For more details on the /unsafe part of the URL, check the Security page.

The safe url for the above URL would look like (check Security for more details):

http://thumbor-server/K97LekICOXT9MbO3X1u8BBkrjbu5/300x200/smart/s.glbimg.com/et/bb/f/original/2011/03/24/VN0JiwzmOw0b0lg.jpg

WARNING

The graphicsmagick engine has an issue with GIF images right now. Most GIF images will error out. We are working on a fix. If you need to update thumbor or graphicsmagick, we strongly recommend using PIL engine.

Installing

Usage

Security and Hosting

Uploading Original Pictures (new API)

Uploading Original Pictures (old API)

Crop, Resize, Detection and Filters

Thumbor Extensible Parts

Others