Skip to content
This repository has been archived by the owner on Jan 21, 2021. It is now read-only.

staticdev/pdf-split-tool

Repository files navigation

Pdf Split Tool

MAINTAINER NEEDED: this project is complete but won't be updated until further notice. If you have interest in improving it, please contact me by creating an issue here .

PyPI Python Version License

Read the documentation at https://pdf-split-tool.readthedocs.io/ Tests Codecov

pre-commit Black

Features

  • Cross-platform: Windows, Mac, and Linux are officially supported.
  • Works with Python 3.8 and 3.9.
  • Splits documents by max size.
  • Checks for high-resolution PDFs before splitting.

Requirements

You need Python 3.8 or above (3.9 recommended) installed on your machine.

Windows users should download Windows x86-64 executable installer and in the installer screen be ensure the option Add Python 3.8 to PATH is checked:

Windows Installation PATH checkbox

Installation

You can install Pdf Split Tool via pip from PyPI:

pip install pdf-split-tool

Note: on Windows you can copy the above command in the cmd program.

Usage

  1. Enter the terminal of your operating system eg. cmd program on Windows or shell on Linux and MacOS.
  2. Choose the one option and execute the command on the terminal:
  • For splits with the default value (20mb) of a specific PDF
pdf-split-tool C:\Users\John\myfile.pdf
  • For splits with the default value (20mb) of all PDFs in a folder
pdf-split-tool
  • You can choose the max size in megabytes with the option -m or --max-size
pdf-split-tool --max-size 50 # for 50 megabytes

Note: you can also use --max-size after the path of a specific PDF and fractional numbers such as "50.5".

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Pdf Split Tool is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.