Skip to content

nihas101/java-kotlin-image-to-pdf-converter

Repository files navigation

JaKoImage2PDF JakoImage2PDF

License: AGPL v3 build status Maintainability codecov

JaKoImage2PDF is a program for converting images to PDFs with the use of iText 7.

Click here for the latest release.

Features

  • Build a single PDF from a directory of images See here
  • Build multiple PDFs from multiple subdirectories of images at once See here
  • Build PDFs from one or multiple ZIP files of images
  • Change the order of the images in the PDF via drag-and-drop and remove unwanted ones
  • Text-only-mode

Requirements

Java 1.8 is required to run this program.

Build Standalone Distribution

To create a standalone distribution as a zip or tar file, run:

./gradlew distZip

or

./gradlew distTar

The distribution is placed under build/distributions.

How to run the converter

To run the program from the distribution, extract the zip or tar file, and run the launch script for your system in the bin folder by double-clicking on it or typing either:

./jaKoImage2Pdf

in the command-line interface or

./jaKoImage2Pdf --noGUI

to run the program in text-only-mode.

How to build a single PDF

In GUI-mode

  1. Run the program.
  2. Simply drag and drop the directory you want to convert or click on Choose directory and select the source-directory of images you want to convert into a PDF.
  3. Reorder images and remove unwanted ones.
  4. Click on Build.

In text-only-mode

  1. Run the program in text-only-mode.
  2. Supply a path to the folder of images you want to convert into a PDF
  3. Type no when asked "Do you want to build multiple PDFs from this source?"
  4. Type yes if the file is a ZIP-file, no otherwise
  5. Reorder images and remove unwanted ones.
  6. Type build
  7. Type no to build the PDF in the same folder as was supplied
  8. Type exit to exit the program or go to step 2 to build more PDFs

How to build multiple PDFs at once

In GUI-mode

  1. Run the program.
  2. Click on Options and check the PDFs from multiple directories-box.
  3. Simply drag and drop the directory of subdirectories you want to convert or click on Choose directory and select the source-directory of subdirectories you want to convert into PDFs.
  4. If you want to alter specific PDFs to be build, double-click on the directory you want to alter to open a second window with it's contents.
    1. Reorder images and remove unwanted ones
    2. Click on the build button in the second window to build the PDF and remove this directory from the main window
  5. Click on Build to build multiple PDFs from the chosen directories.

In text-only-mode

  1. Run the program in text-only-mode.
  2. Supply a path to the directory of subdirectories you want to convert into PDFs
  3. Type yes when asked "Do you want to build multiple PDFs from this source?"
  4. Type yes if the files are ZIP-files, no otherwise
  5. Reorder images and remove unwanted ones.
  6. Type build
  7. Type no to build the PDF in the same folder as was supplied
  8. Type exit to exit the program or go to step 2 to build more PDFs