Skip to main content
Version: Version 1.7

Get started with Python

This guide walks you through the steps to use the Pdftools SDK in a sample project with Python.

tip

Try the Pdftools SDK without a license key for free.

info

The Python interface is implemented as a wrapper around the Pdftools SDK's C API.

Prerequisites​

The Pdftools SDK for Python requires Python 3.6 or higher.

Getting started with a sample project​

Learn how to use the Pdftools SDK using a Python sample project and convert a PDF file to an image.

Download and run the sample​

  1. Download a sample project, and then unzip the file.

  2. Install the Pdftools SDK package by running the following command:

    pip install https://pdftools-public-downloads-production.s3.eu-west-1.amazonaws.com/productkits/PDFSDK/latest/pdftools_sdk-latest.tar.gz

  3. In the command line, navigate to the root directory of the unzipped sample project, where you can find the pdf2_img_simple.py file.

  4. To render the sample PDF file PdfPrimerWhitePaper.pdf to a multi-page TIFF image format, run:

    python ./pdf2_img_simple.py PdfPrimerWhitePaper.pdf PdfPrimerWhitePaper.tiff
note

Run python3 instead on systems where only Python 3 is installed and python is not aliased.

The code sample takes:

  • The input and output files represented as a file name or a file path with the file name.
  • Both file paths (input and output) can be relative or absolute.

Review the following snippet with a placeholder and compare it to the last step of the previous procedure:

python ./pdf2_img_simple.py INPUT_PDF IMAGE_OUTPUT_PATH

Integrate the SDK into your application​

Integrate and initialize the Pdftools SDK into your application by following the instructions in the next sections.

Add the SDK to your project​

  1. Install the Python package:

    pip install https://pdftools-public-downloads-production.s3.eu-west-1.amazonaws.com/productkits/PDFSDK/latest/pdftools_sdk-latest.tar.gz

  2. From the Pdftools SDK code samples page, download any Python code sample.

  3. Unzip a code sample and review the README.md file with usage details. Every code sample includes a README.md with different usage instructions.

  4. Import the following packages in the header of your Python code:

    from ctypes import *
    from pdftools_sdk.pdf import Document
    from pdftools_sdk.pdf2_image import Converter
    from pdftools_sdk.pdf2_image.profiles import Archive
Imports depend on the sample you use

The imports depend on the Python sample you use. Imports displayed in the last step of the previous procedure are valid for the Convert PDF to image sample. Every sample includes a single Python file from which you can copy the imports. In case you want to use another functionality, copy the correct imports into your project with the following steps:

  1. Open the Pdftools SDK code samples.
  2. Download a sample. For example: Decrypt an encrypted PDF
  3. Unzip the downloaded sample.
  4. Open the decrypt.py file, and then copy its imports to the header of your Python code.

Initialize the SDK​

tip

Try the Pdftools SDK without a license key for free.

You can try the Pdftools SDK without a license with watermarked results. To remove the watermark, initialize the Pdftools SDK with your license key with the following steps:

  1. Copy your license key. For more information, review Find the license key.

  2. Uncomment the following method, and then replace the insert-license-key-here with the value of your license key:

    # Sdk.initialize("insert-license-key-here")

    Use the license key in the same format as you copied it. Include the less-than (<) and greater-than (>) signs.

Try it without license key

You can try the Pdftools SDK without a license with watermarked results. For more information, review Pdftools SDK license management. Without a valid license key the output files are watermarked. Get in touch with the Pdftools sales team through the Contact page to get a full license.

tip

Download other sample projects that show you how to implement specific use cases with the Pdftools SDK using Python. See our Code samples page. The samples include: