pdf2thumbnail

pdf2thumbnail

Generate PDF thumbnails.
Click here to see the change log.

• pdf2thumbnail
  • Web Demo
  • Supported OS
  • Requirements
  • Installation
  • API
  • Unit testing
  • Author
  • License

Web Demo

Click here to learn how to use the web demo.

Supported OS

• Linux
• MAC

Requirements

• imagemagick CLI >= v6.9.10
  Installation example:
  • For instance, if you're on OS X you can use Homebrew.

    brew install imagemagick
    

  • For Linux, use yum.

    sudo yum -y install ImageMagick
    

Installation

npm install --save pdf2thumbnail

API

• pdf2thumbnail.getTotalNumberOfPages()

  Get the total number of pages in the PDF document.

  Syntax

  pdf2thumbnail.getTotalNumberOfPages(pdfPathOrDataUrl);
  

  Usage

  const pdf2thumbnail = require('pdf2thumbnail');
  
  const totalPages = await pdf2thumbnail.getTotalNumberOfPages('sample.pdf');
  

  Parameters

  • {string} pdfPathOrDataUrl The path to the PDF file, DataURL.

  Return value

  {Promise<number>} Total number of pages in the PDF document.

  Throws

  • {TypeError} PDF path is empty.
  • {TypeError} Cannot find file in PDF path.

• pdf2thumbnail.writeThumbnails()

  Write a thumbnail for each page of the PDF document.

  Syntax

  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir);
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg'});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg', start: 1});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg', start: 1, end: 2});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg', start: 1, end: 2, archive: true});   
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg', start: 1, end: 2, archive: true, background: '#000'});
  pdf2thumbnail.writeThumbnails(pdfPathOrDataUrl, outputDir, {width: 595, quality: 100, format: 'jpg', start: 1, end: 2, archive: true, background: '#000', offset: 30});
  

  Usage

  • Thumbnail all pages.
    The thumbnail file name is "<original file name>_<page number>.<extension>".

    const pdf2thumbnail = require('pdf2thumbnail');
    
    await pdf2thumbnail.writeThumbnails('sample.pdf', './result');
    // $ ll result
    // -rw-rw-r-- 1 ec2-user ec2-user 101656 Dec 20 18:49 sample_1.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 141934 Dec 20 18:49 sample_2.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 128636 Dec 20 18:49 sample_3.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 384545 Dec 20 18:49 sample.jpg
    

  • Specify thumbnail width, quality, and format.

    const pdf2thumbnail = require('pdf2thumbnail');
    
    await pdf2thumbnail.writeThumbnails('sample.pdf', './result', {width: 595, quality: 100, format: 'png'});
    // $ ll result
    // -rw-rw-r-- 1 ec2-user ec2-user 106689 Dec 20 18:49 sample_1.png
    // -rw-rw-r-- 1 ec2-user ec2-user 169000 Dec 20 18:49 sample_2.png
    // -rw-rw-r-- 1 ec2-user ec2-user 132571 Dec 20 18:49 sample_3.png
    // -rw-rw-r-- 1 ec2-user ec2-user 361910 Dec 20 18:49 sample.png
    

  • Thumbnails for pages 2-3.

    const pdf2thumbnail = require('pdf2thumbnail');
    
    await pdf2thumbnail.writeThumbnails('sample.pdf', './result', {start: 2, end: 3});
    // $ ll result
    // -rw-rw-r-- 1 ec2-user ec2-user 141934 Dec 20 18:49 sample_2.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 128636 Dec 20 18:49 sample_3.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 283503 Dec 20 18:49 sample.jpg
    

  • An archive containing all thumbnails is also generated at the same time.

    const pdf2thumbnail = require('pdf2thumbnail');
    
    await pdf2thumbnail.writeThumbnails('sample.pdf', './result', {archive: true});
    // ll result*
    // -rw-rw-rw- 1 ec2-user ec2-user 718211 Dec 20 18:04 result.zip
    
    // result:
    // -rw-rw-r-- 1 ec2-user ec2-user 101656 Dec 20 18:04 sample_1.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 141934 Dec 20 18:04 sample_2.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 128636 Dec 20 18:04 sample_3.jpg
    // -rw-rw-r-- 1 ec2-user ec2-user 384545 Dec 20 18:04 sample.jpg
    

  Parameters

  • {string} pdfPathOrDataUrl The path to the PDF file, DataURL.
  • {string} outputDir Directory path to output thumbnails.
  • {number} options.width? Width of output thumbnail (px). Default is 595 (px).
  • {number} options.quality? The quality of the thumbnail to output (1-100). Default is 100.
  • {string} options.format? The format of the output thumbnail. Default is jpg.
  • {number} options.start? Starting page position starting from 1.
  • {number} options.end? End page position starting from 1.
  • {boolean} options.archive?
    If true, it generates an archive (.zip) containing all images with the same name as the output directory (outputDir).
    Default is false.
  • {string|{r: number, g: number, b: number, alpha: number}} options.background?
    Background color of merged thumbnails.
    This option accepts a color name, a hex color, or a numerical RGB, RGBA, HSL, HSLA, CMYK, or CMYKA specification.
    For example, blue, #dddddff, rgb(255,255,255), etc.
    Default is white.
  • {number} options.offset? Offset (in pixels) between merged images. Default is 0.

  Return value

  {Promise<{thumbnailPaths: string[], mergedPath: string}>} Thumbnail Result.
  This is an object with the following elements.

  • {string[]} thumbnailPaths Path list of output thumbnail files.
    For example, sample_1.jpg, sample_2.jpg.
  • {string} mergedPath The path of the image file from which the thumbnails for each page are merged.
    For example, sample.jpg.
  • {string} archivePath? The path to the archive containing all thumbnails.
    This is only set if the archive option is true when creating thumbnails.

  Throws

  • {TypeError} PDF path is empty.
  • {TypeError} Cannot find file in PDF path.
  • {TypeError} The width option is not a number greater than 1.
  • {TypeError} The quality option is not a number between 1 and 100.
  • {TypeError} The start option is not a number greater than 1.
  • {TypeError} The end option is not a number greater than 1.
  • {TypeError} The offset option is not a number greater than 0.

Unit testing

npm run test
# > pdf2thumbnail@1.0.2 test
# > jest

#  PASS  __tests__/pdf2image.test.js
#   PDF to Thumbnail
#     ? Should write thumbnails of all pages. (639 ms)
#     ? Should write thumbnails for pages 2-3. (738 ms)
#     ? Should be a thumbnail of the specified width. (515 ms)
#     ? An archive of thumbnails should be created. (606 ms)
#     ? Each thumbnail in the merged image should be written at 30px intervals. (656 ms)
#     ? Should write thumbnails in png format. (896 ms)

#  PASS  __tests__/exception.test.js
#   Case of exception
#     ? Should throw an error if the PDF path parameter is empty. (331 ms)
#     ? Should throw an error if the PDF is not found. (1 ms)
#     ? Should throw an error if the width option is 0. (1 ms)
#     ? Should throw an error if width option is less than 0. (1 ms)
#     ? Should throw an error if quality option is 0. (1 ms)
#     ? Should throw an error if quality option is less than 0. (1 ms)
#     ? Should throw an error if quality option is greater than 100. (2 ms)
#     ? Should throw an error if the start option is 0.
#     ? Should throw an error if start option is less than 0.
#     ? Should throw an error if end option is 0.
#     ? Should throw an error if end option is less than 0.
#     ? Should throw an error if offset option is less than 0.

#  PASS  __tests__/number-of-pages.test.js
#   Total number of PDF pages
#     ? Should get the number of pages in the PDF. (180 ms)

# Test Suites: 3 passed, 3 total
# Tests:       19 passed, 19 total
# Snapshots:   0 total
# Time:        6.17 s
# Ran all test suites.

Author

Takuya Motoshima

• github/takuya-motoshima
• twitter/TakuyaMotoshima
• facebook/takuya.motoshima.7

License

MIT

Changelog

[1.0.5] - 2023/6/8

Changed

• Fixed PDF image conversion method (pdf2thumbnail.writeThumbnails) not to delete output directory that already existed.
• The method to convert PDF to images (pdf2thumbnail.writeThumbnails) and the method to get the number of pages in a PDF (pdf2thumbnail.getTotalNumberOfPages) can now process PDF in DataURL format.