General

Feel free to download and use the scripts listed on this site. You run scripts at your own risk: I accept no liability for anything that you may think was caused by any of these scripts. Always take the necessary precautions. Most importantly, try out a script on copies of your documents, never on originals. When using scripts that work or may work on files in folders (such as the batch processor), consider zipping the files first or copying the contents of the folder somewhere else.

The scripts are in JavaScript and can be used both in Windows and on Macs. Several are in rough-and-ready form in that they use no interface, and variable information (style names, folder names, etc.) needs to be changed in the code. That's how I use most scripts. If you want an interface for any of the interfaceless scripts here, I'll add it for a fee.

The scripts are free to use, but acknowledgement will be appreciated. Any of these scripts can be customised; contact me for any special requirements (details at bottom of this page).

Downloading and installing scripts

To download a script from this site, right-click Show script and choose Save Target/Link As at the foot of the script's description page, then place the script in the script folder (locations are given below). Some pages have a Download script button instead of a "Show script" button; just click that when you see it.

Files that you downloaded which have the extension .jsx are ready to be run. Some scripts, however, are zipped. When you unzip these .zip files, you get a file with the extension .jsxbin. Treat such files as if they were .jsx files: place them in the scripts folder.

The Script folder

Where you store your Javascripts depends on your operating system and platform. The easiest way to find out where your scripts are is as follows. In InDesign, display the Scripts panel (Window > Utilities > Scripts; CS4 and earlier: Window > Automation > Scripts).

You can use either folder you see there: scripts in the Application folder can be run by all users, those in User only by the current user. Anyway, right-click the folder that you want to use and in the fly-out pick Reveal in Explorer (PC) or Reveal in Finder (Mac).

indesign script location

In the window that opens now, click on the folder Scripts Panel. This is the folder where you should store your scripts.

Running a script

In InDesign, you run a script from the Script panel (Window > Utilities > Scripts; CS4 and earlier: Window > Automation > Scripts). Look for the script's name in the panel and double-click it. This goes for .jsx scripts and for .jsxbin scripts. (Scripts can be assigned to shortcut keys for easy access. You can also use the script launcher listed on the contents page -- my preferred way of running scripts.)

Modifying a script

Scripts are plain text files and can be edited in any plain-text editor (Notepad, BBEdit, etc.). A convenient way to edit a script after you've installed it is this: in the script palette, right-click the script's name (or click the fly-out) and pick "Edit script". This will open the script in the ESTK -- InDesign's JavaScript editor. Don't be intimidated by all kinds of windows you see or the different colours you see in the text: it's just plain text. Make any changes you want or are instructed to make, then save the script (File > Save) and exit the ESTK. (Note: scripts with the extension .jsxbin cannot be modified.)

Users of CS5 and later can do themsleves no bigger favour than installing InTools's Script Bay, an extension that makes modyfying scripts a breeze.

InDesign versions

Most scripts run in newer versions of InDesign, especially from CS3. But if a script doesn't run and you suspect or know that the script was written for a version older than your InDesign version, create a folder under your own script folder and include InDesign's version number in the name. The name must be Version n.0 Scripts , where n is the Indesign version. Keep in mind that this is not the CS version: CS6 is version 8 (when Adobe created the CS system, InDesign was at version 2, therefore CS corresponds with ID version 3, CS2 with ID version 4, etc.). InDesign CC is version number 9.

Query locations

The Text, GREP, Glyph, and Object queries you save in the Find/Change dialog are stored in separate folders. We'll show here how to find the folder for GREP queries -- the other three folders are sisters of this folder and are tracked down in the same way.

Open the Scripts panel in InDesign and navigate to the Scripts folder (see Script locations, above). Explorer shows you these folders:

Explorer GREP queries folder

Now double-click the Find-Change Queries folder, then double-click the GREP folder. There you are. The XML files you see there are your saved queries.

Donations/payment

To make a payment, please press the button below. By default, the generic 'InDesign script' will appear on your receipt, but you can change that text. This is Paypal's payment system; you don't need a Paypal account to use it: you can use several types/brands of credit and debit card.
Peter Kahrel's paypal account

Contact

You can reach me via the address here.