PDF Joiner is a straightforward command-line utility designed for macOS users, aimed at combining multiple PDF files into a single document effortlessly. Leveraging the built-in macOS PDF joining capabilities, it provides a seamless experience for managing PDF files without the need for additional software.

Key Features

• Native macOS Integration: Utilizes the built-in system tools to ensure reliability and ease of use.
• Flexible Usage: Accepts multiple PDF files, supports custom output filenames, and can operate on all PDF files within a specified directory.

Requirements

• Operating System: Compatible with macOS.
• Development Environment: Requires Go 1.18 or later for building from source.

Basic Usage

The basic command structure for joining PDFs is:

pdf-joiner [-o output.pdf] file1.pdf file2.pdf [file3.pdf ...]

• The -o option allows users to specify the output file path. If not provided, the output defaults to a timestamped filename in the current directory.

Examples

• To join two PDF files:

pdf-joiner file1.pdf file2.pdf

• To merge multiple files with a custom output name:

pdf-joiner -o merged.pdf file1.pdf file2.pdf file3.pdf

• To join all PDF files present in a directory:

pdf-joiner -o merged.pdf /path/to/directory/*.pdf

Development and Testing

The project supports testing, universal builds for various architectures, and cleanup operations to maintain the environment. To run tests, use:

make test

For building on both Intel and Apple Silicon Macs, the command is:

make build-universal-darwin

PDF Joiner simplifies the process of merging PDF files on macOS, providing a reliable and efficient tool for users needing to consolidate documents.