DimonSmart.PdfCropper — nugetz

DimonSmart/DimonSmart.PdfCropperv1.9.1

Name: DimonSmart.PdfCropper
Author: DimonSmart

✓ Verified.NET 8.0.NET 9.0

A cross-platform .NET library that intelligently trims PDF pages to actual content using content-based or bitmap-based analysis. Supports Windows, Linux, macOS and other .NET-compatible platforms. Perfect for preparing e-books and documents by removing excessive margins and whitespace.

github.com ↗

License

0BSD

Deps

Install Size

—

Vulns

✓ 0

Published

Feb 12, 2026

Get Started

$ dotnet add package DimonSmart.PdfCropper

Readme

DimonSmart.PdfCropper

DimonSmart.PdfCropper is a cross-platform .NET library that intelligently trims PDF pages to actual content using two different methods. The library exposes a simple API through PdfSmartCropper.CropAsync, which accepts a PDF document in memory and returns a new PDF with recalculated CropBox and TrimBox on every non-empty page.

Example

Here's a visual example of what PdfCropper does - it removes unnecessary margins and whitespace:

Before Cropping	After Cropping

dotnet add package DimonSmart.PdfCropper

Install-Package DimonSmart.PdfCropper

using DimonSmart.PdfCropper;

byte[] cropped = await PdfSmartCropper.CropAsync(inputBytes, CropSettings.Default);

var settings = new CropSettings(
    CropMethod.ContentBased,
    margins: new CropMargins(left: 2f, bottom: 1f, right: 3f, top: 2f));

using DimonSmart.PdfCropper;

var profile = PdfCropProfiles.Aggressive;
byte[] cropped = await PdfSmartCropper.CropAsync(
    inputBytes,
    profile.CropSettings,
    optimizationSettings: profile.OptimizationSettings,
    logger: null);

Key	Description	Crop settings	Optimization settings
`simple`	Default behaviour for quick cropping.	Content-based, keeps edge content, 0.5pt margin.	No extra optimisation (same as `PdfOptimizationSettings.Default`).
`ebook`	Recommended for reading PDFs on e-readers.	Content-based, ignores artefacts that touch the page edge, excludes repeated content, 1pt margin.	Default optimisation.
`aggressive`	Tight crop plus the strongest clean-up and compression.	Content-based, ignores edge artefacts, excludes repeated content, 0.25pt margin.	Full compression, smart mode, unused-object removal, metadata cleanup, PDF 1.7 target.

using DimonSmart.PdfCropper;

public sealed class MyLogger : IPdfCropLogger
{
    public void LogInfo(string message) => Console.WriteLine($"[INFO] {message}");
    public void LogWarning(string message) => Console.WriteLine($"[WARN] {message}");
    public void LogError(string message) => Console.Error.WriteLine($"[ERROR] {message}");
}

var logger = new MyLogger();
byte[] cropped = await PdfSmartCropper.CropAsync(inputBytes, CropSettings.Default, logger);

# Run the ready-made Windows build (download link above)
DimonSmart.PdfCropper.Cli.exe input.pdf output.pdf

# Use the e-book preset (ignores edge artefacts, keeps 1pt margin)
DimonSmart.PdfCropper.Cli.exe input.pdf output.pdf --preset ebook

# Apply the aggressive preset with verbose logging
DimonSmart.PdfCropper.Cli.exe input.pdf output.pdf --preset aggressive -v

# Emit detailed diagnostics for a single page
DimonSmart.PdfCropper.Cli.exe input.pdf output.pdf --debug-page 2

# Apply per-side margins
DimonSmart.PdfCropper.Cli.exe input.pdf output.pdf --margin-left 1 --margin-right 3 --margin-top 2 --margin-bottom 0.5

# Merge multiple PDFs matched by a mask into a single output
DimonSmart.PdfCropper.Cli.exe "scans/*.pdf" merged/scans.pdf --merge

# From source (cross-platform)
dotnet run --project src/DimonSmart.PdfCropper.Cli/DimonSmart.PdfCropper.Cli.csproj -- input.pdf output.pdf --preset simple

Feature	ContentBased	BitmapBased
Speed	⚡ Fast	🐌 Slower
Quality	✅ Preserves vector quality	✅ Preserves vector quality
Accuracy	Good for standard documents	Better for complex layouts
Use case	Most PDFs	PDFs with complex graphics

public interface IPdfCropLogger
{
    void LogInfo(string message);
    void LogWarning(string message);
    void LogError(string message);
}

public interface IPdfCropDebugLogger
{
    bool ShouldLogDebugForPage(int pageIndex);
    int MaxObjectLogs { get; }
}

public enum CropMethod
{
    ContentBased = 0,  // Analyzes PDF content
    BitmapBased = 1    // Renders to bitmap
}

DimonSmart/DimonSmart.PdfCropperv1.9.1

Get Started

Readme

DimonSmart.PdfCropper

Example

Download the CLI

Platform Support

Installation

Features

Usage

Minimal crop (three lines)

Aggressive crop with all clean-up switches

Built-in presets

Custom logger

Command Line Utility

CLI Options

Cropping Methods Comparison

Development

Platform-Specific Notes

API Reference

IPdfCropLogger Interface

IPdfCropDebugLogger Interface

CropMethod Enum