124

Is there a quick one-liner to combine multiple pdfs into one?

I know it can be done using Preview.app

Improve this question

9 Answers 9

Reset to default
155

Have a look at "Combining PDF files on the command line in OSX" in Joining PDF Files in OS X From the Command Line.

It turns out that from Tiger onwards, OSX ships with a Python script that does exactly what you need. The script is already executable, and Python is pre-installed on OS X, so all you need to do to run it is opening the Terminal and typing

"/System/Library/Automator/Combine PDF Pages.action/Contents/Resources/join.py" -o PATH/TO/YOUR/MERGED/FILE.pdf /PATH/TO/ORIGINAL/1.pdf /PATH/TO/ANOTHER/2.pdf /PATH/TO/A/WHOLE/DIR/*.pdf

Also on the linked page it suggests making a symbolic link for the join.py file to make typing easier however they omitted the -s in ln -s ... ..., and without it, a hard link is created. Probably wouldn't matter, however though I'd mention it.

Improve this answer
9
  • Worked for me. One great thing here is avoiding having to install extra packages that you may never use again. Thanks.
    – W7GVR
    Jan 27, 2019 at 18:48
  • 4
    Warning: I had PDFs where it messed up the rotation of several pages
    – adius
    Jun 26, 2019 at 8:44
  • 2
    This really shouldn't be the accepted answer. This removes hyperlinks in the merged file. Some people are going to be very unhappy when they discover this and don't have access to the original files anymore. Preview.app screws up hyperlinks as well. Instead, use this: apple.stackexchange.com/a/365073/247390
    – Daan
    Feb 2, 2020 at 20:47
  • 3
    This doesn't seem to work for me anymore, the past year. I just get a blank output.
    – Chris F Carroll
    Apr 14, 2020 at 16:12
  • 1
    Still works on MacOS Monterey, just make sure you run it with Python2 (even though it's EOL ... )
    – Gerard
    Apr 13 at 14:57
91

Just install Ghostscript using Brew with command:

brew install gs

Then run command with all files listed:

gs -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite -sOutputFile=merged.pdf source1.pdf source2.pdf source3.pdf
Improve this answer
10
  • 6
    @user3439894 many people already have these common packages installed and are already using gs so for future reference this solution would be just as convenient.
    – htor
    Dec 6, 2017 at 15:26
  • 3
    @user3439894 i see the confusion. i'm addressing you because you were questioning the value of this answer. using homebrew to install command line utilities is very common these days, so i wouldn't call it a waste of time. for many people this answer provides an equally good solution as yours.
    – htor
    Dec 6, 2017 at 17:05
  • 9
    this worked for me, the py command didn't
    – Thieme Hennis
    Mar 27, 2018 at 20:23
  • 2
    As per Thieme Hennis' comment, the join.py script crashes for me in High Sierra with a segmentation fault. But gs works perfectly.
    – arcdale
    May 24, 2018 at 8:06
  • 1
    Combining 20X 60KB PDF files: Using the Python script >>> 22.1MB Using gs >>> 288KB (and way faster)
    – pooya13
    Oct 16, 2019 at 5:20
24

I found the free Coherent PDF Command Line Tool to be the best option. It is very fast, lossless, and does not mess up orientation or hyperlinks as some other solutions did. Format is:

cpdf file1.pdf file2.pdf -o output.pdf
Improve this answer
5
  • 1
    This should be the accepted answer. Preview.app as well as join.py screw up hyperlinks.
    – Daan
    Feb 2, 2020 at 20:52
  • 1
    Also, cpdf *.pdf -o output.pdf works beautifully if you have many pdfs to combine in one directory.
    – spops
    Jan 11, 2021 at 21:53
  • Yep this is the best, it's also a one stop shop for all things you'd want to do with pdfs....
    – FrodmanG
    Oct 15, 2021 at 8:31
  • I used this approach to take a 625mb PDF down to 225mb, and I can't see the difference (used the squeeze option as well, to compress it!). I also tried the automator option, it worked, but much larger file size, as it didnt offer the option to compress (565 mb)
    – Brad Parks
    Jan 15 at 14:55
  • I prefer an installation with brew, so I choose pdfunite.
    – Timo
    Jun 26 at 11:53
16

You can use pdfunite which is part of the Poppler package and can be installed via Homebrew (brew install poppler).

pdfunite 1.pdf 2.pdf 3.pdf combined_pdf.pdf

Merges the three PDF files into combined_pdf.pdf.

Improve this answer
2
  • 1
    Or use a for-loop with numerical sorting, as suggested by: stackoverflow.com/a/23643544/861597
    – Francis Laclé
    Oct 25, 2021 at 1:22
  • With GNU Parallel and pdfunite, I used this for combining the most resumes added to a folder since the last time I checked: find . -name \*.pdf -newer toDec3.pdf -print0 | parallel -0 -X -j1 -x pdfunite {} toDec12.pdf
    – Joshua Goldberg
    Dec 17, 2021 at 18:59
13

building on on @Bartosz Petryński's nice answer, we can make own minimal cpdf utility on top of GhostScript:

brew install gs

cpdf () { 
  gs -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite -sOutputFile="$1" "${@:2}"
}

then use it like:

cpdf merged.pdf file1.pdf file2.pdf file3.pdf
Improve this answer
6

Apple's python script in the Automator action is very slow, as it uses CoreGraphics's CGPDFDocument APIs, rather than the newer PDFKit framework. It also imports the entire CoreGraphics library, rather than just the required APIs.

An alternative, faster python script, can be found here:

This script also adds a Table of Contents to the PDF, listing each component file (and merging existing ToCs), which Apple's does not.

It can be used on the command line (with PDF filenames as arguments), or in an Automator shell script action, to make a Quick Action/Service for the Finder.

Improve this answer
2
  • 2
    As a test, using the time command in conjunction with your joinpdfs.py script, the built-in join.py script and two files ~200 MB each, your joinpdfs.py script was 9 seconds faster than the built-in join.py script, with of course the added benefit of having the TOC intact. Nice! +1
    – user3439894
    Jan 18, 2019 at 19:27
  • BTW 9 seconds might not sound like a lot but it was 1/3 the overall time of the built-in script, so 1/3 the time faster is significant.
    – user3439894
    Jan 18, 2019 at 19:34
2

FWIW, I've written a quick little program that lets you do this without having to rely on external dependencies like the system python and such. On github here: pdfmerge and pretty simple to use, can either pass it a list of PDF files to merge with pdfmerge in1.pdf in2.pdf ... out.pdf, pass it a list of files to merge in a text file like pdfmerge infileslist.txt out.pdf or just do the current directory in ABC order with pdfmerge out.pdf. I wrote it as a learning project, so free and open and you can get the latest binary from the releases tab on github.

Improve this answer
3
  • Since Python is by default installed in and as a part of macOS, I do not necessarily consider it an external dependency per se. In other words, to use what is already available out of the box in macOS to join PDF files, the join.py script from the Combine PDF Pages action in Automator, nothing else needs to be downloaded or installed, yet to use yours I'd have to download and install it. Also didn't see a binary at the link.
    – user3439894
    Jan 18, 2019 at 18:29
  • 1
    BTW I did peruse your code and it's interesting that you are using two of the core components (Foundation and Quartz) that the python script is already using too. Is there anything in your code that is intrinsically better to sway ones usage of it over what is already offered by default without having to download anything, whereas with yours one has to take additional and extra steps to use it?
    – user3439894
    Jan 18, 2019 at 18:29
  • 1
    For people who don't use Python for anything else, it probably makes more sense to use the Apple-provided script. But for people who do use Python, it can be a big hassle to manage multiple versions (the system Python is 2.7, modern Python is 3.x) with different module installations and stuff. On my machine, for example, my $PATH points to a totally different Python. This can be solved with judicious use of shebangs and such, but I find it annoying. YMMV, of course. Also, direct link to binary download page: github.com/paultopia/pdfmerge/releases/latest
    – Paul Gowder
    Jan 19, 2019 at 17:11
1

If you want to be able to combine multiple pages onto one sheet, I wrote a tool that can do that (or just a normal combine). Mac PDFNUp

You can get the binary download on the releases button.

Usage: pdfnup --output <out> --nup 1/2/6 <filename>

Improve this answer
-1

Homebrew Formulae

brew cask install combine-pdfs

This is a GUI app that supports merging many pdf's. very powerful.

Improve this answer
1
  • 1
    The first 1000 pages are free, then you need to buy a license
    – jwinandy
    Feb 15 at 14:09

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .