Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/pdfsync

                   This is the README file for pdfsync
                          a LaTeX package for
               synchronizing between source and pdf output

* Presentation
pdfsync.sty allows one to synchronize between LaTeX source and pdf output.
When used with a text editor and a PDF viewer that both support pdfsync,
you can navigate from the source to the output and vice versa.
This is some kind of srcltx ported from dvi to pdf.

When you typeset foo.tex with pdfsync.sty and either pdfetex or xetex,
a foo.pdfsync auxiliary file is created. It only contains geometrical information
used by text editors or PDF viewers for synchronization.
You can delete this file when you are done.

Actually, iTeXMac, iTeXMac2, TeXShop, AucTeX are
text editors implementing pdfsync support at various level.
iTeXMac, iTeXMac2, TeXShop, TeXniscope, PDFView are
PDF viewers implementing pdfsync support at various level.

This is most certainly the last update of this package,
this technology will most certainly be embedded in pdftex and XeTeX engines and won't rely any longer on pdf techniques.
As a matter of fact, synchronization will be available both for dvi, xdv and pdf.
Also it will work the same for Plain, LaTeX, ConTeXt and whatsoever.
Moreover, synchronization will not modify any package.

* News
- 01/30/2007: version 1.1 is the second version officially available.
Some internals were modified in order to provide a stronger \pdfsyncstart, \pdfsyncstop pair.
Paul Taylor's diagram package now works with pdfsync. You may have to update.
Anticipating over pdftex improvements, this package will load with option "off" if the \synchronize macro is defined

* Installation
If this package is not already included in your TeX distribution,
just copy the pdfsync.sty file to the proper location.
On Mac OS X, it can be


where you should replace YOUR_HOME_DIRECTORY by its actual value.

* Usage
Put \usepackage{pdfsync} in your LaTeX preamble.

In case of severe conflicts with another package, try instead


If pdfsync breaks only some part of your LaTeX code, you can try to
enclose it in \pdfsyncstop \pdfsyncstart pair. If you want to add
more control point add \pdfsync at sensible locations in your code.
In that case, \usepackage[off]{pdfsync} will disable pdf synchronization
and \relax the above commands.

* Bugs
pdfsync uses extremely sensible code.
You should not use pdfsync on final documents because
it can change the layout rather significantly
(different page/line breaks are the most obvious changes),
despite this is rather rare,
17th Murphy's law states that it will happen to you when it absolutely must not...

The accuracy of pdf synchronization depends on the application used for that purpose.
iTeXMac2 is actually the most accurate implementation because it combines pdfsync
with pdf searching. The lack of accuracy, is not a bug in pdfsync a priori.

You should report bugs and package conflicts to

     jlaurens AT users DOT sourceforge DOT net.

* Credits:
The original idea of pdfsync was proposed by Piero D'Ancona in the summer of 2003.
He and Jerome Laurens both created the first working package.
Hans Hagen and David Kastrup made very significant enhancements to the original code.

* License
This program is free software; you can redistribute it and/or modify
it under the terms of the The LaTeX Project Public License version 1.3c at least

* Home page
The official site where you will find both the latest version and the .pdfsync file specifications is


copyright 2007, jlaurens AT users DOT sourceforge DOT net

Down­load the con­tents of this pack­age in one zip archive (257.1k).

pdf­sync – Pro­vide links be­tween source and PDF

The pack­age runs with pdf or , and cre­ates an aux­il­iary file with ge­o­met­ri­cal in­for­ma­tion to per­mit ref­er­ences back and forth be­tween source and PDF, as­sum­ing a con­form­ing ed­i­tor and PDF viewer.

Ver­sion 2008-01-25
Li­cense The Project Public Li­cense
Copy­right2006–2008 J Lau­rens
Main­tainerJ Lau­rens
Con­tained inTeX Live as pdf­sync
MiKTeX as pdf­sync
Topics sup­port for pack­age or doc­u­ment de­bug­ging
See also vpe
Guest Book Sitemap Contact Contact Author