1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
*Note: this repository is provided **as-is** and the code is not being actively
developed. If you wish to improve it, that's greatly appreciated: please make
the changes and submit a pull request, I'll gladly merge it or help you out
with finishing it. However, please do not expect any kind of support, including
implementation of feature requests or fixes. If you're not a developer and/or
willing to get your hands dirty, this tool is probably not for you.*
[](https://github.com/vslavik/diff-pdf/actions/workflows/build.yml)
## Usage
diff-pdf is a tool for visually comparing two PDFs.
It takes two PDF files as arguments. By default, its only output is its return
code, which is 0 if there are no differences and 1 if the two PDFs differ. If
given the `--output-diff` option, it produces a PDF file with visually
highlighted differences:
```
$ diff-pdf --output-diff=diff.pdf a.pdf b.pdf
```
Another option is to compare the two files visually in a simple GUI, using
the `--view` argument:
```
$ diff-pdf --view a.pdf b.pdf
```
This opens a window that lets you view the files' pages and zoom in on details.
It is also possible to shift the two pages relatively to each other using
Ctrl-arrows (Cmd-arrows on MacOS). This is useful for identifying translation-only differences.
See the output of `$ diff-pdf --help` for complete list of options.
## Obtaining the binaries
Precompiled version of the tool for Windows is available as part of
[the latest release](https://github.com/vslavik/diff-pdf/releases/tag/v0.5.1)
as a ZIP archive, which contains everything you need to run diff-pdf. It will
work from any place you unpack it to.
Alternatively, if you use [Chocolatey](https://chocolatey.org/), you can install
diff-pdf on Windows with:
```
$ choco install diff-pdf
```
On Mac, if you use [Homebrew](https://brew.sh), you can use it to install diff-pdf with it:
```
$ brew install diff-pdf
```
On Mac, if you use [Macports](https://macports.org), you can install diff-pdf with:
```
$ port install diff-pdf
```
On Fedora and CentOS 8:
```
$ sudo dnf install diff-pdf
```
Precompiled version for openSUSE can be downloaded from the
[openSUSE build service](http://software.opensuse.org).
## Compiling from sources
The build system uses Automake and so a Unix or Unix-like environment (Cygwin
or MSYS) is required. Compilation is done in the usual way:
```
$ ./bootstrap
$ ./configure
$ make
$ make install
```
(Note that the first step, running the `./bootstrap` script, is only required
when building sources checked from version control system, i.e. when `configure`
and `Makefile.in` files are missing.)
As for dependencies, diff-pdf requires the following libraries:
- wxWidgets >= 3.0
- Cairo >= 1.4
- Poppler >= 0.10
#### CentOS:
```
$ sudo yum groupinstall "Development Tools"
$ sudo yum install wxGTK wxGTK-devel poppler-glib poppler-glib-devel
```
#### Ubuntu:
```
$ sudo apt-get install make automake g++
$ sudo apt-get install libpoppler-glib-dev poppler-utils libwxgtk3.0-gtk3-dev
```
#### macOS:
Install Command Line Tools for Xcode:
```
$ xcode-select --install
```
and install [Homebrew](https://brew.sh) or [MacPorts](https://www.macports.org) to manage dependencies, then:
```
$ brew install automake autoconf wxmac poppler cairo pkg-config
```
or
```
$ sudo port install automake autoconf wxWidgets-3.0 poppler cairo pkgconfig
```
Note that many more libraries are required on Windows, where none of the
libraries Cairo and Poppler use are normally available. At the time of writing,
transitive cover of the above dependencies included fontconfig, freetype, glib,
libpng, pixman, gettext, libiconv, libjpeg and zlib.
### Compiling on Windows using MSYS + MinGW
1. First of all, you will need working MinGW installation with MSYS2 environment
and C++ compiler. Install MSYS2 by following [their instructions](https://www.msys2.org).
1. Once installed, launch the MSYS2 MinGW shell. It will open a terminal window;
type `cd /c/directory/with/diff-pdf` to go to the directory with diff-pdf
sources.
1. You will need to install additional MSYS components that are not normally
included with MSYS, using these commands:
```
$ pacman -Syu
$ pacman -S automake autoconf pkg-config make zip
$ pacman -S mingw-w64-i686-{gcc,poppler,wxWidgets}
```
1. Build diff-pdf in the same way as in the instructions for Unix above:
```
$ ./bootstrap # only if building from git repository
$ ./configure
$ make
```
1. To build a ZIP archive will all DLLs, run
```
$ make windows-dist
```
## Installing
On Unix, the usual `make install` is sufficient.
On Windows, installation is not necessary, just copy the files somewhere. If
you built it following the instructions above, all the necessary files will be
in the created ZIP archive.
|
