Package {pdfcombiner}

Title:	Graphical User Interface for Manipulating PDF and Image Files
Version:	1.9.9
Maintainer:	Steve Choy <steve.choy@outlook.com>
Description:	A 'shiny' app that supports merging of PDF and/or image files with page selection, removal, or rotation options. It is a fast, free, and secure alternative to commercial software or various online websites which require users to sign-up, and it avoids any potential risks associated with uploading files elsewhere.
License:	MIT + file LICENSE
URL:	https://github.com/stevechoy/pdfcombiner, https://lagom.shinyapps.io/pdfcombiner/
BugReports:	https://github.com/stevechoy/pdfcombiner/issues
Encoding:	UTF-8
Imports:	shiny, pdftools, qpdf,
Suggests:	bslib, rJava, staplr, testthat (≥ 3.0.0), magick, officer, openxlsx, shinythemes
Depends:	R (≥ 3.5.0)
Config/testthat/edition:	3
Config/roxygen2/version:	8.0.0
NeedsCompilation:	no
Packaged:	2026-09-30 23:46:11 UTC; magnu
Author:	Steve Choy [aut, cre, cph]
Repository:	CRAN
Date/Publication:	2026-10-01 01:10:02 UTC

Convert to Excel

Description

Convert to Excel

Usage

convert_to_excel(pdf_path, output_path)

Arguments

Value

a Excel workbook (as a side effect)

Convert a PDF to PNG images

Description

Renders each page of a PDF as a PNG. Must be called inside a Shiny withProgress() block because it updates the progress bar.

Usage

convert_to_images(pdf_path, output_dir, dpi = 300)

Arguments

Value

Path to the output file: the PNG itself if the PDF has one page, otherwise a ZIP archive containing one PNG per page. Errors if no pages are converted.

Convert to PowerPoint

Description

Convert to PowerPoint

Usage

convert_to_powerpoint(pdf_path, output_path)

Arguments

Value

a print statement (as a side effect)

Convert to Word

Description

Convert to Word

Usage

convert_to_word(pdf_path, output_path)

Arguments

Value

print statement (as a side effect)

Format a file size in KB

Description

Rounds to 0 decimal places and adds comma separators.

Usage

format_kb(x)

Arguments

Value

A character string, e.g. format_kb(1131.987) returns "1,132".

Convert an image to a PDF

Description

Flattens any transparency onto a white background and writes the image to a PDF. Multi-frame images (e.g. GIF, TIFF) become one page per frame.

Usage

image_to_pdf(img_path, pdf_path, dpi = 72)

Arguments

Value

The path to the PDF that was written (pdf_path).

Check if a Number is a Non-Negative Numeric

Description

This internal function checks whether the input is a non-negative numeric scalar. It can optionally throw an error if the input is invalid.

Usage

is_non_negative_numeric(x, name_of_func, throw_error = TRUE)

Arguments

Details

This function is intended for internal use within the package to validate numeric inputs. It ensures that the input is numeric, has a length of 1, and is greater than 0.

Value

A logical value:

• TRUE if x is a non-negative numeric scalar.

• FALSE if x is not a non-negative numeric scalar'.

Parse Pages of a PDF

Description

Parse Pages of a PDF

Usage

parse_pages_to_remove(input_string)

Arguments

Value

a numeric vector containing pages to remove

Launches PDF Combiner

Description

Launches the PDF Combiner shiny App. Instructions on usage are included on the left hand side of the page. By default it uses the bootstrap theme, allowing minimization of the sidebar. Set argument boostrap_theme = FALSE to turn this off.

Usage

pdfcombiner(
  max_file_size = 500,
  bootstrap_theme = TRUE,
  sidebar_width = 700,
  defaultwm_fontsize = 50,
  defaultwm_col = "gray80",
  defaultwm_alpha = 0.6,
  defaultwm_rot = 45,
  defaultwm_fontface = "bold",
  defaultwm_height = 11,
  defaultwm_width = 8.5,
  image_dpi = 300,
  compact_level = "ebook",
  linearize = FALSE,
  verbose = TRUE
)

Arguments

Details

The user is highly recommended to also install the staplr package as it supports bookmarks, however it uses Java so you may need to install Java separately if your system does not currently have it. In addition, the magick package is recommended for supporting uploading of image files.

Value

a Shiny App

Note

All PDF files are stored locally in a per-session temporary directory, given by the tempdir() function.

See Also

https://github.com/stevechoy/pdfcombiner, pdftools, qpdf

Examples

if (interactive()) {
pdfcombiner(bootstrap_theme = FALSE) # Do not use bootstrap theme (if `shiny` version is < 1.7.4)
}

Sanitize File names

Description

Sanitize File names

Usage

sanitize_filename(filename)

Arguments

Value

a sanitized character for the file name

Sums up disk spaces used for PDF files

Description

Sums up disk spaces used for PDF files

Usage

sum_disk_space(file_list)

Arguments

Value

A character containing total size in kilobytes

Watermark Stamp

Description

Watermark Stamp

Usage

watermark_stamp(
  input_pdf,
  output_pdf,
  watermark_text,
  watermark_fontsize = 50,
  watermark_col = "gray80",
  fallback_col = "gray80",
  watermark_alpha = 0.6,
  watermark_rot = 45,
  watermark_fontface = "bold",
  watermark_height = 11,
  watermark_width = 8.5
)

Arguments

Value

a path of output PDF