Installation Issues

You’re trying to install one of our plug-ins and it does not work.

This page is for you – it’s chock-full of hints and tips that should help you diagnose and fix the problem.

Before anything, please make sure you have installed the latest versions of everything – most installation issues are caused by outdated or incompatible software versions.

A number of older tools don’t work with the latest version of APID ToolAssistant: BoxedStepAndRepeat, ClipAThing, HistoryLog, ImpositionCompanion, LikeFindsLike, PlaceAndScale, PlaceAutoSynchronizer, SendToMaster, StylePainter. Depending on feedback, we might or might not upgrade these.

If you absolutely need to use one of these, make sure you download the older version of APID ToolAssistant shown on their product pages. However, installing such older version of APID ToolAssistant will disable any of the more recent plug-ins like TextExporter, StoryParker – it’s either/or.

Re-download all components to make sure you have up-to-date materials. The easiest way to find the various product pages is to go via our InDesign Downloads page.

If the problem is not a version issue, you can work through the following step-by-step procedure. You might want to print this page out so you can ‘tick’ each step as you work through it.

Please follow the instructions as accurately as possible – e.g. if we say ‘restart InDesign and open a document’ – you really need to open a document after restarting InDesign.

If you find any inaccuracies in the procedures below, please let us know at support@rorohiko.com

Step 1. First, restart your computer.

Then launch InDesign, and check whether there is an API menu.

If you can see the API menu, skip to step 2.

If you cannot see the API menu, exit out of InDesign and navigate to the InDesign application folder on your hard disk.

If you need help finding the InDesign application folder on Macintosh, click here.

If you need help finding the InDesign application folder on Windows, click here.

Inside the InDesign application folder, you’ll find the Plug-Ins folder – this is where you need to copy a number of files to make things work. After copying one or more items you should restart InDesign.

We need to double-check that APID ToolAssistant is correctly installed.

There are many versions of APID ToolAssistant: Mac versions, Windows versions. We have a CS5 version available, as well as a CS4 version,… and so on.

All of these are mutually incompatible – so if you install a Mac version onto a Windows computer, or a CS5 version on InDesign CS4, it won’t work.

If you have multiple versions of InDesign installed, make sure you’re not mixing up two installations. We’ve had some users who installed the plug-in in the Plug-Ins folder for their CS4 installation, and were then expecting to see it appear when they launched CS5.

An overview:

 

PlatformFile(s) to put into Plug-Ins folder
Mac InDesign CS:APIDToolAssistantCS.pln
Mac InDesign CS2:APIDToolAssistantCS2.pln.framework
Mac InDesign CS3:APIDToolAssistantCS3.InDesignPlugin
Mac InDesign CS4:APIDToolAssistantCS4.InDesignPlugin
Mac InDesign CS5:APIDToolAssistantCS5.InDesignPlugin
Windows InDesign CS:APIDToolAssistantCS.pln
Windows InDesign CS2:APIDToolAssistantCS2.pln
Windows InDesign CS3:APIDToolAssistantCS3.pln
Windows InDesign CS4:APIDToolAssistantCS4.pln
Windows InDesign CS5:
(2 items)
APIDToolAssistantCS5.pln
(APIDToolAssistantCS5 Resources)

If in doubt, start over: remove the APID ToolAssistant, and re-download it from the following page:

http://www.rorohiko.com/apidtoolassistant

Any additional files (.spln files, additional plug-ins like Color2Gray or Sudoku, .png files with graphical elements) need also to be copied into the Plug-Ins folder.

Make sure the file(s) in your Plug-Ins folder do not have a .ZIP file name extension.

Acceptable file name extensions for stuff you put into the Plug-Ins folder are (depending on the platform): .pln, .pln.framework, .InDesignPlugin, .spln, .png

Our downloadable material is contained in compressed .ZIP files. These .ZIP files won’t work if you drag them into your plug-ins folder.

You need to decompress them so you can get at their contents. Put the downloaded .ZIP file(s) on your desktop.

If you need help decompressing the .ZIP file on Macintosh, click here

If you need help decompressing the .ZIP file on Windows, click here

Drill into the decompressed folder – below a sample of what it would look like for InDesign CS5 for Macintosh.

And here is a sample of what it would look like for InDesign CS5 in Windows. InDesign CS5 on Window is a special case – you need to copy two items. Both the .pln file and the resources folder need to be copied.
Don’t copy the ReadMe.txt into your Plug-Ins folder.

After decompressing, you need to drag the correct plug-in into your InDesign plug-ins folder.

Some of our .ZIP files contain nested .ZIP files – decompress these too in the same way, until you can get at the file you need.

After you have successfully installed the plug-in and verified it works, you can file away or delete the downloaded .ZIP file and delete the decompressed folder from your desktop – you don’t need them any more.

Relaunch InDesign. If you can see the API menu, skip to step 2.

If you cannot see the API menu and you are on Windows using InDesign CS5, click here.

If you cannot see the API menu and you are on Windows using InDesign CS4, click here.

Restart your computer. Start InDesign.

If you can see the API menu, skip to step 2.

If the API menu still fails to appear, you might need to do a reset of the InDesign preferences.

First, try creating a temporary user account and see whether things work when logged in as another user. Click here for more info.

If things do work from a temporary user account, you need to reset your preferences.

This will remove all customizations you have done – so it’s not a decision to take lightly, but sometimes there is no way around it.

If you need help resetting your preferences on Macintosh, click here.

If you need help resetting your preferences on Windows, click here.

Relaunch InDesign. If you can see the API menu, skip to step 2.

If you still cannot see the API menu, you can try a ‘deep reset’.

To do a ‘deep reset’ of your InDesign preferences on Macintosh, click here.

To do a ‘deep reset’ of your InDesign preferences on Windows, click here.

Relaunch InDesign. If you can see the API menu, skip to step 2.

If you still cannot see the API menu probably something is really wrong – the most common cause is some installation problem with your computer.

This can be caused by all kinds of things: permission problems, corruptions, software conflicts, bad Windows updates, viruses…

If you end up at this point, and you feel out of your depth – seek help from someone knowledgeable who can help you diagnose and resolve the issue.

You can also e-mail us at support@rorohiko.com – please provide us with ample information.

Try to provide us with the following info – we cannot see your screen or your computer, so you need to be our eyes:

- tell us what tool are you trying to install. Too many people e-mail us ‘it does not work’ and leave us guessing what ‘it’ might be.
- what platform (Windows/Mac) and version of InDesign you are using
- screen shots. At least a screen shot of the API – APID ToolAssistant… window, and anything else that might be relevant
- sample documents (preferably small).
- any crash reports you might have
- a system profile if you are on Macintosh
- where we can reach you (in case your e-mail does not work) – a phone number, a fax, an alternate e-mail address.
- anything else you think is relevant.

Things to try:

- Create a new user account on your computer and try again.
- Try on another computer.
- Reinstall InDesign (argh!) and try again.
- Reinstall the operating system (oomph!) and try again.

Step 2. Open a new document in InDesign.

Most of our tools don’t appear in the API menu until you have a document open.

Check the API menu – do you see the menu items corresponding to the tool you installed (e.g. TextExporter, Color2Gray…) ?

If you can see the menu items, the tool is properly installed. Go to the product page to read more about how the tool is used – the easiest way to find the product page is to go via our InDesign Downloads page. Click here to go to the InDesign Downloads page.

If you cannot see the menu items, the tool is not properly installed. Read on.

APID ToolAssistant all by itself has no useful functionality for an end-user – it needs to be complemented with one or more .spln files and possibly some additional plug-ins.

Nearly all of our tools necessitate two downloads: one download is APID ToolAssistant, the second download is the tool you want to install. After the downloads you need to decompress the .ZIP files, and copy two, three or more items to your InDesign Plug-Ins folder.

Make sure you download the tool you desire to install, and copy the relevant file(s) into your InDesign Plug-Ins folder.

Any additional files (.spln files, additional plug-ins like Color2Gray or Sudoku, .png files) need to be copied into the Plug-Ins folder also.

The InDesign Plug-Ins folder resides in the InDesign application folder.

If you need help finding the InDesign application folder on Macintosh, click here.

If you need help finding the InDesign application folder on Windows, click here.

Make sure none of the file(s) in your Plug-Ins folder have a .ZIP file name extension.

Acceptable file name extensions for stuff you put into the Plug-Ins folder are (depending on the platform): .pln, .pln.framework, .InDesignPlugin, .spln, .png

Our downloadable material is contained in compressed .ZIP files. These .ZIP files won’t work if you drag them directly into your Plug-Ins folder.

You need to decompress them so you can get at their contents. Put the downloaded .ZIP file(s) on your desktop.

If you need help decompressing the .ZIP file on Macintosh, click here

If you need help decompressing the .ZIP file on Windows, click here

Open the decompressed folder. Below a sample of what it could look like for Color2Gray for InDesign CS5 on Macintosh.
If you encounter another .zip inside the folder, decompress it in the same manner, by double-clicking it. Then go into the decompressed folder to find what you need.

 

Below a sample of what it could look like for Color2Gray for InDesign CS5 on Windows.

InDesign CS5 on Windows is a special case – in addition to a .pln and an .spln you must also copy a resources folder.

After decompressing, you need to drag the .spln file or files into your plug-ins folder, as well as any additional plug-in files (.pln), resource folders (parenthesized name), and possibly some additional graphics files (.png).

Some of our .zip files contain nested .zip files – decompress these too in the same manner, until you can get the file you need.

After you verified all necessary items are installed, relaunch InDesign, and open a document.

If the menu items for the tool still fails to appear in the API menu, you might need to do a reset of the InDesign preferences.

First, try creating a temporary user account and see whether things work when logged in as another user. Click here for more info.

If things do work from a temporary user account, you need to reset your preferences.

This will remove all customizations you have done – so it’s not a decision to take lightly, but sometimes there is no way around it.

If you need help resetting your preferences on Macintosh, click here.

If you need help resetting your preferences on Windows, click here.

Relaunch InDesign and open a document.

If the menu items for the tool still fails to appear in the API menu, you might need to do a ‘deep reset’ of the InDesign Preferences.

To do a ‘deep reset’ of your InDesign preferences on Macintosh, click here.

To do a ‘deep reset’ of your InDesign preferences on Windows, click here.

Relaunch InDesign and open a document.

If you still cannot see the menu items for the tool probably something is really wrong – the most common cause is some installation problem with your computer.

This can be caused by all kinds of things: permission problems, corruptions, software conflicts, bad Windows updates, viruses…

If you end up at this point, and you feel out of your depth – seek help from someone knowledgeable who can help you diagnose and resolve the issue.

You can also e-mail us at support@rorohiko.com – please provide us with ample information.

Try to provide us with the following info – we cannot see your screen or your computer, so you need to be our eyes:

- tell us what tool are you trying to install. Too many people e-mail us ‘it does not work’ and leave us guessing what ‘it’ might be.
- what platform (Windows/Mac) and version of InDesign you are using
- screen shots. At least a screen shot of the API – APID ToolAssistant… window, and anything else that might be relevant
- sample documents (preferably small).
- any crash reports you might have
- a system profile if you are on Macintosh
- where we can reach you (in case your e-mail does not work) – a phone number, a fax, an alternate e-mail address.
- anything else you think is relevant.

Things to try:

- Create a new user account on your computer and try again.
- Try on another computer.
- Reinstall InDesign (argh!) and try again.
- Reinstall the operating system (oomph!) and try again.