Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

gs-batch-pdf

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.7 Club score Visit github.com

What gs-batch-pdf is

gs-batch-pdf is a free, open-source command-line tool for processing batches of PDFs in parallel on Linux, macOS, and Windows. It uses Ghostscript for compression, with presets for screen, ebook, printer, prepress, and default output. It can also convert PDFs to PDF/A-1, PDF/A-2, or PDF/A-3; the latter two require Ghostscript 10.04.0 or newer for correct conversion. Run it on a directory tree with recursive search and see progress for each file. For output handling, choose to keep the smaller file or always retain the processed version, and add filename prefixes or suffixes. On errors, it can prompt, skip the failed file, or stop. Silent options support unattended runs, including overwrites and skipping errors. You can also pass Ghostscript command-line options. Setup requires Python 3.12 or later and a separately installed Ghostscript executable. The project recommends pipx, though pip is supported too. The tool is MIT-licensed; Ghostscript is AGPL-licensed.

Who it suits

It suits users who want to automate PDF processing from a command line across Linux, macOS, or Windows. It also fits batch workflows that need configurable error handling and file selection.

Good to know, and what to watch

  • Processes files in parallel and searches directories recursively.
  • Offers five Ghostscript compression presets.
  • Supports PDF/A-1, PDF/A-2, and PDF/A-3 conversion.
  • Provides silent options for unattended batch runs.
  • Requires Python 3.12 or later.
  • Ghostscript must be installed separately.
  • Correct PDF/A-2 and PDF/A-3 conversion requires Ghostscript 10.04.0 or later.

Free

Free

Open source

The verdict

gs-batch-pdf brings batch controls, compression, and PDF/A conversion to a command-line workflow. Plan for its Python and Ghostscript prerequisites before using it.

What the maker publishes

Automation
The README documents silent and unattended batch use, including options to force overwrites, suppress opening the output folder, and skip errors. source
Batch controls
It can recursively process directory trees and report per-file progress. source
Batch search
It can recursively search directory trees when run with the -r flag. source
Compression
It supports Ghostscript compression presets /screen, /ebook, /printer, /prepress, and /default. source
Custom options
Users can pass arbitrary Ghostscript command-line options to the tool. source
Error handling
On processing errors, it can prompt, skip failed files, or abort. source
File handling
It can keep the smaller of the original and processed files, or always keep the new version, and supports filename prefixes and suffixes. source
Install requirements
The README lists Python 3.12 or later and Ghostscript as prerequisites, and recommends installing the package with pipx; pip is also supported. source
Integration
PDF processing uses Ghostscript, which must be installed separately. source
Integrations
The tool uses Ghostscript for PDF processing and can be installed with pipx or pip. source
License
The README says gs-batch-pdf is licensed under MIT and describes Ghostscript as AGPL-licensed. source
PDF/A
It converts PDFs to PDF/A-1, PDF/A-2, or PDF/A-3, and the README says PDF/A-2 and PDF/A-3 require Ghostscript 10.04.0 or higher for correct conversion. source
Platforms
The README states support for Windows, Linux, and macOS. source
Purpose
gs-batch-pdf is a command-line tool for batch processing PDFs with parallel execution. source
Requirements
Running the tool requires Python 3.12 or newer and an installed Ghostscript executable. source
Security and licensing
The project says gs-batch-pdf is licensed under MIT and identifies Ghostscript as AGPL-licensed; the README does not state security certifications or compliance claims. source
Support
The project invites bug reports and feature requests through GitHub Issues and contributions through pull requests. source

Checked against the maker's pages on 11 Oct 2026.