latex-pdf-size-optimizer 0.1.1

A tool to optimize LaTeX projects by converting images and compressing PDFs.

LatexPDFSizeOptimizer

A tool to optimize LaTeX projects by converting vector graphics to JPG, pre-compiling TikZ figures, and compressing the final PDF.

Features

• Image Conversion: Recursively converts .eps and .pdf images to .jpg to reduce file size.
• Dynamic Resizing: Detects exact dimensions of PDF figures to prevent cropping.
• Smart Caching: Skips redundant conversions using hash-based verification.
• TikZ Optimization: Extracts tikzpicture environments, compiles them, and replaces them in source.
• Robust Compilation: Auto-cleans build artifacts to prevent corruption.
• PDF Compression: Compresses final output to target size using Ghostscript.

Installation

pip install .

Usage

Navigate to your LaTeX project directory and run:

latex-pdf-size-optimizer

(Settings are loaded from latex-pdf-size-optimizer.toml or CLI arguments)

Arguments

Argument	Description	Default
path	Path to project root	.
--main-tex	Main LaTeX file	thesis.tex
--max-size	Target PDF size in MB	5.0
--dpi	Image resolution	200
--compression	Ghostscript setting (/screen, /ebook)	/ebook
--exclude	Files to exclude	[]
--dry-run	Preview actions without changes	False

Example

latex-pdf-size-optimizer --dry-run