The helper program

TagAlly Pro is two parts: the panel inside InDesign, and a small helper program that runs on your own computer. The helper does the work InDesign cannot do itself — repairing the exported PDF and validating it against PDF/UA-1. This page is where you get it.

If you already have the plugin, you do not need this page. The panel brings the same archive with it: under ⚙ Advanced → Set up the helper program you choose a folder and it places the file there. Nothing is written to disk unless you ask for it. This page is for the other cases: a second computer, a colleague, or a machine where installing plugins is restricted.

Everything stays on your machine. The helper listens only on the local loopback interface, so nothing on your network can reach it, and no document is ever sent anywhere.

What you need first

Three things have to be present before the helper can do its job. All three are free.

Node.js, version 18 or newer
Runs the helper itself. The installer from nodejs.org is enough; no configuration is needed.
A Java runtime
Used by the PDF repair step. Any current Java installation works. On macOS you may already have one.
veraPDF
The free open-source validator that performs the actual PDF/UA check. The helper finds it by itself in the usual installation locations.

Download

Download the helper, version 1.0.0

ZIP archive, about 12 MB, for macOS and Windows alike. It contains no installer and changes nothing on your system: you unpack it wherever you like and start it from there.

If you want to be sure the file reached you unchanged, compare its SHA-256 checksum against the one we publish in the accompanying file. On macOS the command is shasum -a 256, on Windows certutil -hashfile with SHA256.

Unpack and start

  1. Unpack the archive. A folder named tagally-engine appears. Put it wherever you keep your tools; the location does not matter, but it should not be a folder that gets emptied automatically, such as Downloads on some systems.
  2. Start it by double-clicking START TagAlly (macOS).command or START TagAlly (Windows).bat. Apart from those two and config.json, the folder holds only a programm subfolder you never need to open.
  3. A terminal window opens and stays open. That window is the helper: leave it running while you work, and close it when you are done.
  4. In InDesign, open the TagAlly Pro panel and press Engine reachable? under Check & post-process. It should answer with the version number.

On macOS, the first start may be refused because the file came from the internet. Right-click the file, choose Open, and confirm once; after that the double-click works normally.

Once it is unpacked you may delete the archive. Do not delete the unpacked folder: it is the program itself, and it is needed every time you start the helper.

Updating

Unpack the new version over the old folder and start it again. The starter notices that an older helper is still running, shuts it down and takes over. You do not have to close anything by hand.

If it does not start

The window says Node.js was not found
Node is missing or not on the system path. Install it from nodejs.org and start the helper again.
The window says port 8474 is already in use
Another program occupies the port the helper needs. Close it, or tell us which program it is and we will look for a way around.
The panel says veraPDF was not found
The automatic search did not turn it up. Open config.json in the helper folder and enter the full path to the veraPDF program under verapdfPath.

Still stuck? The troubleshooting section of the FAQ covers the common cases in more detail, and you can always write to us.