https://github.com/coobird/thumbnailator

Thumbnailator - a thumbnail generation library for Java
https://github.com/coobird/thumbnailator

fluent-interface image-processing image-resizer java thumbnails

Last synced: 4 days ago
JSON representation

Thumbnailator - a thumbnail generation library for Java

• Host: GitHub
• URL: https://github.com/coobird/thumbnailator
• Owner: coobird
• License: mit
• Created: 2015-07-25T05:38:33.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-02-08T11:56:05.000Z (11 months ago)
• Last Synced: 2024-10-29T11:24:51.711Z (about 2 months ago)
• Topics: fluent-interface, image-processing, image-resizer, java, thumbnails
• Language: Java
• Homepage:
• Size: 11.1 MB
• Stars: 5,168
• Watchers: 182
• Forks: 789
• Open Issues: 52
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-java - Thumbnailator - High-quality thumbnail generation library. (Projects / Imagery)

README

        
_*June 28, 2023: Thumbnailator 0.4.20 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?

![](https://raw.githubusercontent.com/wiki/coobird/thumbnailator/img/home/home-image.png)

_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.20/)

* [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.