# Technical Documentation: coobird/thumbnailator

> ℹ️ **Provenance:** In-Tree Documentation (6 Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/coobird/thumbnailator) · Recency: Active (< 180 days)

## File: README.md

_*October 1, 2025: Thumbnailator 0.4.21 has been released!
See [Changes](https://github.com/coobird/thumbnailator/wiki/Changes) for details.*_

_*Thumbnailator is now available through
[Maven](https://github.com/coobird/thumbnailator/wiki/Maven)!*_

# What is Thumbnailator?



_Thumbnailator_ is a thumbnail generation library for Java.

# Why Thumbnailator?
Making high-quality thumbnails in Java can be a fairly difficult task.

Learning how to use the Image I/O API, Java 2D API, image processing,
image scaling techniques, ... but fear not! _Thumbnailator_ will take care
of all those things for you!

Thumbnailator is a single JAR file with no dependencies to external libraries,
making development and deployment simple and easy. It is also available on
the Maven Central Repository for easy inclusion in Maven projects.

# How simple is Thumbnailator?

_Thumbnailator_'s fluent interface can be used to perform fairly complicated
thumbnail processing task in one simple step.

For example, creating JPEG thumbnails of image files in a directory, all
resized to a maximum dimension of 640 pixels by 480 pixels while preserving
the aspect ratio of the original image can be performed by the following:

```
Thumbnails.of(new File("path/to/directory").listFiles())
    .size(640, 480)
    .outputFormat("jpg")
    .toFiles(Rename.PREFIX_DOT_THUMBNAIL);
```

The fluent interface provided by the _Thumbnailator_ simplifies the task of
making thumbnails into a single method call!

No need to access the Image I/O API and manually manipulate `BufferedImage`s
through `Graphics2D` objects. _Thumbnailator_ does all of that for you.

# What can Thumbnailator do?

The following pages have more information on what _Thumbnailator_ can do:

* [Features](https://github.com/coobird/thumbnailator/wiki/Features)
* [Examples](https://github.com/coobird/thumbnailator/wiki/Examples)
* [Thumbnailator API Documentation](https://coobird.github.io/thumbnailator/javadoc/0.4.21/)
* [Frequently Asked Questions](https://github.com/coobird/thumbnailator/wiki/FAQ)

# Disclaimer
*Thumbnailator is still early in its development, and the APIs are subject to
change at any time.*

# License
Thumbnailtor is released under the MIT License.

---

## File: CONTRIBUTING.md

# Contributing to Thumbnailator

Thank you for your interest in contributing to Thumbnailator!

## Pull Requests

Please note that pull requests are not being accepted.

## Bug Reports and Feature Requests

Contributions in the form of bugs reports or feature enhancements are welcome!

But first, please read the [Frequently Asked Questions (FAQ)](https://github.com/coobird/thumbnailator/wiki/FAQ).

If you think you've found a bug or have an idea for a new feature or improvement, please search through [issues](https://github.com/coobird/thumbnailator/issues) first.
Only if it hasn't been reported yet, please file a new issue.

---

## File: src/test/resources/Configurations/all_false.txt

thumbnailator.disableExifWorkaround=false
thumbnailator.debugLog=false
thumbnailator.debugLog.exifWorkaround=false
thumbnailator.conserveMemoryWorkaround=false

---

## File: src/test/resources/Configurations/all_true.txt

thumbnailator.disableExifWorkaround=true
thumbnailator.debugLog=true
thumbnailator.debugLog.exifWorkaround=true
thumbnailator.conserveMemoryWorkaround=true

---

## File: .github/ISSUE_TEMPLATE.md

## Expected behavior
_Please describe what you are expecting the library to perform._



## Actual behavior
_Please describe the actual behavior you are experiencing, including stack
trace and other information which would help diagnose the issue._



## Steps to reproduce the behavior
_Please enter step-by-step instructions for reproducing the actual behavior.
Including code can be helpful in diagnosing issue, but please keep the code to
a minimal that will reproduce the behavior._



## Environment
_Please provide vendor and version information for the Operating System,
JDK, and Thumbnailator. Please feel free to add any other information
which may be pertinent._

- OS vendor and version:
- JDK vendor and version:
- Thumbnailator version:

---

## File: .github/PULL_REQUEST_TEMPLATE.md

**Hello! Thank you for your interest in contributing to Thumbnailator!**

Please note that pull requests are not being accepted at the moment.
Any pull requests are subject to closure without any actions taken.

Contributions in the form of bugs reports or feature enhancements through [issues](https://github.com/coobird/thumbnailator/issues) are always welcome.

--- METRICS ---
- Files Extracted: 6
- Estimated Token Budget: ~1002 tokens
- Recency Window: Active (< 180 days)
- Canonical Reference: https://codewiki.google/github.com/coobird/thumbnailator