@brakebein/pdf2png

Convert pages of a PDF document to PNG images


Keywords
convert, pdf, png, pdf2png, image, ghostscript
License
MIT
Install
npm install @brakebein/pdf2png@1.0.0

Documentation

pdf2png

This is a fork of tr3ysmith/Pdf2Png. Along with the usage of TypeScript and promises, this version:

  • adds support to read PDF file from local file system
  • properly compiles to both CommonJS and ESM

Install

$ npm install @brakebein/pdf2png

Setup

Windows

No additional setup is needed for Windows, ghostscript is included with this package.

Linux

If you want to use it with linux, you will need to install ghostscript via your package manager.

$ sudo apt-get update
$ sudo apt-get install ghostscript

Mac OSX

You will need to install ghostscript on Mac using brew.

$ brew install ghostscript

Usage

import { PdfConvert, PdfConvertOptions } from '@brakebein/pdf2png';

// create a PdfConvert object for a PDF file
// using a Buffer
const pdfConverter = new PdfConvert(buffer);
// using a Web url
const pdfConverter = new PdfConvert('https://example.com/example.pdf');
// using a local file
const pdfConverter = new PdfConvert('./folder/example.pdf');

// pass options
const options: PdfConvertOptions = {
  // resolution of the output image in dpi
  resolution: 600,
  // path to ghostscript bin directory (only Windows)
  // defaults to executable shipped with this package
  ghostscriptPath: 'path/to/gs/bin'
};
const pdfConverter = new PdfConvert('./folder/example.pdf', options);

// get the number of pages of the PDF
const pages = await pdfConverter.getPageCount();

// get page 1 as a PNG Image Buffer
const buffer = await pdfConverter.convertPageToImage(1);
await fs.writeFile("example_page1.png", buffer);

// Dispose the converter object when you're done using it, 
// otherwise the pdf tmp file will not be removed
// (but should be automatically removed on process exit).
// To manually call `dispose()` allows you to run multiple operations
// within long-living processes, e.g. backend server, without piling up tmp files.
pdfConverter.dispose();