gs-batch-pdf
github.com
- Free plan
- Windows
- macOS
- Linux
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.
Plans
Every plan and priceFree
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.