Software:Thumbor

From HandWiki
Short description: Open-source image processing web service
Thumbor
Developer(s)Globo.com
Initial releaseScript error: No such module "Date time".
Stable release
7.7.7 / Script error: No such module "Date time".
Repositorygithub.com/thumbor
Written inPython
Operating systemCross-platform
PlatformCross-platform
TypeImage processing
LicenseMIT License
Websitethumbor.org

Thumbor is an open-source image processing service for real-time image resizing and manipulation. Originally developed by Globo.com, the tool is written in Python and supports smart image cropping using facial recognition and other object detection algorithms. Thumbor is free software licensed under the MIT License and distributed through GitHub.[1] It is notably used by large-scale organizations, including the Wikimedia Foundation,[2] Amazon Web Services,[3] and Square for their image processing infrastructure, and is recognized as a popular self-managed image content delivery network (CDN).[4]

Features

Thumbor enables dynamic resizing, allowing images to be generated in various sizes upon request. It can also leverage facial recognition and interest point detection algorithms to automatically crop images in a visually relevant way. Additionally, Thumbor provides filter support, enabling the application of effects such as brightness, contrast, and blur.

Thumbor also integrates with multiple backend systems, including Amazon S3, Google Cloud Storage, and Redis for storage and caching. Security features include encrypted URL signatures to prevent unauthorized manipulation.

Usage

Thumbor is used by companies requiring large-scale, real-time image manipulation—especially in news portals.,[5][6] e-commerce platforms,[7][4][8][9] and web applications that demand high-performance media delivery.[10]

Notable examples

The Wikimedia Foundation, which operates Wikipedia and other projects, uses Thumbor as part of its image processing infrastructure.[2] [11] [12] Since June 2017, all thumbnail traffic for public and beta wikis has been served through Thumbor. In February 2018, support was extended to private wikis,[13] and in April of the same year, the previous MediaWiki-based thumbnailing system was decommissioned. As of April 2023, Thumbor began serving production traffic via Kubernetes.[14]

Amazon uses Thumbor as part of its image processing infrastructure. The Serverless Image Handler solution, integrated with Amazon CloudFront, enables real-time image resizing, conversion, and filter application using Thumbor alongside AWS Lambda. Amazon’s official documentation lists supported filters such as blur, grayscale, equalize, sharpen, and smart crop, which can be applied via URL.[3]

Operation

Server-based architecture

Thumbor operates as a web service, processing images on demand. It receives HTTP requests with parameters such as image size, quality, cropping, and other adjustments. The server then manipulates the image according to the received parameters and returns the modified image to the client.

URL as interface

The primary interface for interacting with Thumbor is through URLs. These URLs can include various parameters for image manipulation, such as resizing (width, height),[15] filters[16] (e.g., blur, rotate), cropping,[17] and more. Thumbor processes the image based on the parameters passed in the URL.

Example URL: https://thumbor.example.com/unsafe/300x200/smart/https://example.com/image.jpg

In this example:

  • 300x200 defines the final dimensions of the image.
  • smart applies a smart cropping algorithm that attempts to focus on the most relevant content of the image.
  • https://example.com/image.jpg is the original image URL (source), which will be fetched and processed by Thumbor.

The segment unsafe in the URL indicates that the image will be processed without requiring a security signature. This behavior can be configured depending on deployment settings.

See also

References

  1. "thumbor/thumbor". GitHub – Thumbor contributors. https://github.com/thumbor/thumbor. 
  2. 2.0 2.1 "The journey to Thumbor, part 1: rationale – Wikimedia Tech Blog" (in en-US). 2017-06-20. https://techblog.wikimedia.org/2017/06/20/the-journey-to-thumbor-part-1-rationale/. 
  3. 3.0 3.1 Amazon Web Services. "Use supported Thumbor filters". AWS Documentation. https://docs.aws.amazon.com/solutions/latest/serverless-image-handler/use-supported-thumbor-filters.html. 
  4. 4.0 4.1 Engineering, Square (18 April 2019). "Dynamic Images with Thumbor" (in en). https://medium.com/square-corner-blog/dynamic-images-with-thumbor-a430a1cfcd87. 
  5. "Thumbor: Escalabilidade em processamento de imagens com reconhecimento facial para 20 milhões de brasileiros" (in pt). https://www.infoq.com/br/presentations/thumbor-escalabilidade-processamento-de-imagens/. 
  6. "feat: Support AVIF format encoding by fdintino · Pull Request #1476 · thumbor/thumbor" (in en). https://github.com/thumbor/thumbor/pull/1476#issuecomment-1284583632. 
  7. Boeira, Marcelo (10 October 2018). "The Fast and the Payloadless" (in en). https://medium.com/heycar/the-fast-and-the-payloadless-566b3aef890e. 
  8. "Experimental exports - Hooks and Components" (in en). https://developers.vtex.com/docs/guides/faststore/building-sections-experimental-exports-hooks-and-components. 
  9. "How Yipit Scales Thumbnailing with Thumbor and Cloudfront - Yipit Django Blog". 15 February 2024. http://tech.yipit.com/2013/01/03/how-yipit-scales-thumbnailing-with-thumbor-and-cloudfront/. 
  10. "Use image CDNs to optimize images | Articles" (in en). https://web.dev/articles/image-cdns. "Thumbor is the most popular self-managed image CDN. It's open-source and free to use." 
  11. "The journey to Thumbor, part 2: thumbnailing architecture – Wikimedia Tech Blog" (in en-US). 2017-11-17. https://techblog.wikimedia.org/2017/11/17/the-journey-to-thumbor-part-2-thumbnailing-architecture/. 
  12. "The journey to Thumbor, part 3: development and deployment strategy – Wikimedia Tech Blog" (in en-US). 2017-11-20. https://techblog.wikimedia.org/2017/11/20/the-journey-to-thumbor-part-3-development-and-deployment-strategy/. 
  13. Wikimedia Foundation (2018-02-22). "Thumbor support for private wikis deployed". Wikimedia Tech Blog. https://techblog.wikimedia.org/2018/02/22/thumbor-support-for-private-wikis-deployed/. 
  14. Wikimedia Foundation (April 2023). "Thumbor". Wikimedia Tech Blog. https://wikitech.wikimedia.org/wiki/Thumbor. 
  15. "Crop and Resize Algorithms — Thumbor 7.7.7 documentation". https://thumbor.readthedocs.io/en/latest/crop_and_resize_algorithms.html#resizing-the-image. 
  16. "Filters — Thumbor 7.7.7 documentation". https://thumbor.readthedocs.io/en/latest/filters.html. 
  17. "Crop and Resize Algorithms — Thumbor 7.7.7 documentation". https://thumbor.readthedocs.io/en/latest/crop_and_resize_algorithms.html#cropping-the-image.