Skip to content

Adds a watermark on your paper pre-prints with all information needed to refer to the final version.


Notifications You must be signed in to change notification settings


Repository files navigation

Paper copyright-watermarker

Adds a watermark on your paper pre-prints with all information needed to refer to the final version.

Given a PDF and the related BibTeX file, automatically generates a new PDF file with watermark explaining that it is a pre-print version of the published manuscript, and adds citation and BibTeX of the final paper in an extra page. Errata corrige files can be appended as well, optionally.

All pre- and post-prints on my website ( are watermarked with this toolkit. Curious? Keep on reading!


BibTeX files should have already been tidied by BibTool ( and contain one entry (excluding referenced ones). This is already done by the script. You'd better invoke it first on your BibTeX files.

It requires the installation of:

It has been tested on Ubuntu Linux 16.04+ machines and on a Mac OS X Lion computer.


To run it, launch first (you will see that you need some options – follow the suggestion!) and then The former slices a BibTeX file with (possibly) many entries into single .bib files, which are also linted by bibtool. The latter creates the watermark on existing pre-prints. You can modify that script to run it with your files. More explanations below.

Usage example

Some folders are already filled in with example material.

In bibsource/ you can find a BibTeX file with two sample publications, which I named diciccio.bib for egocentrism. Ideally, it would be your own BibTeX file with your publications.

To lint it and split it into single-entry bibliography files, to be stored in bibs/ for example, run:

./ bibsource/DiCiccio.bib bibs true

The last parameter imposes to remove existing files from the bibs/ directory, so watch out. You should see the two files preloaded in bibs/ as the result: Surnamev-etal-Symp2017.bib and Author-etal-Conf2018.bib. Notice that the file names are automatically generated based on the BibTeX keys of the respective entries.

In pre-prints/ you can find the PDF files of the papers. At this stage, have a look at You should see that is invoked twice to add the copyright watermark on those pre-prints, associated to the respective BibTeX single-entry files:

./ "bibs/Surnamev-etal-Symp2017.bib" "pre-prints/Surnamev-etal-Symp2017.pdf" "copyright-marked"
./ "bibs/Author-etal-Conf2018.bib" "pre-prints/Author-etal-Conf2018.pdf" "copyright-marked"

The results are stored in copyright-marked/.

Notice that every page has as a super-imposed footnote its DOI and publisher. A last page is also appended with bibliographic information. I created for convenience of batch calls. Feel free to invoke directly on single files, of course.

The software also relies on an auxiliary folder (tmp/) to store temporary data. For debugging reasons, the software does not remove the temporary files at the end of the run. To change the location of the folder, feel free to alter the following line in


Have fun!


Adds a watermark on your paper pre-prints with all information needed to refer to the final version.








No releases published


No packages published