auto-thumbnail

A thumbnailing library.

Converts various file formats into thumbnail image.

Support image, video, PDF, SVG, RAW, audio cover, and Office embedded thumbnails via optional features.

Installation

To use auto-thumbnail in your Rust project, add it to your Cargo.toml.

[dependencies]

auto-thumbnail = { version = "0.2", features = ["full"] }

Feature flags

API

Create a thumbnail:

use auto_thumbnail::Thumbnailer;

let thumbnailer = Thumbnailer::default();
let result = thumbnailer.create_thumbnail("demo/1.webp", "demo/output1.webp");

Decode an image without writing a thumbnail (shared by thumbnail generation and downstream callers):

use auto_thumbnail::{decode_image, decode_and_thumbnail, decode_for_thumbnail};

let img = decode_image("photo.hdr")?;
let thumb = decode_and_thumbnail("logo.ico", 256)?;
let svg = decode_for_thumbnail("icon.svg", 512)?; // routes svg/raw/audio/office

Blank-frame detection (video skip / Office placeholder filter):

use auto_thumbnail::{is_effectively_blank, is_rgba_blank};

Quality Control

Set compression quality 1-100, default 90.

Supported Formats

Image

decode_image / image thumbnails use the enhanced decode path (magic sniff, ICO fallback, HDR/EXR tone mapping). Platform Shell/GDI is not included—callers should add OS-specific fallbacks for HEIC, HDR AVIF, etc.

Video

PDF

SVG (feature = "svg")

RAW (feature = "raw")

Audio cover (feature = "audio")

Office embedded (feature = "office")

Platform Shell/GDI and EMF rasterization are not included—callers (e.g. cherry-box) add OS-specific fallbacks.

Output Formats

• WebP (.webp) - Modern format, excellent compression
• JPEG (.jpeg) - Good compression, lossy
• PNG (.png) - Lossless, supports transparency

Building

Some file types require additional setup and can be disabled via features if unneeded.

Video thumbnails depend on ffmpeg. See rust-ffmpeg

PDF thumbnails depend on pdfium. See pdfium-render