| Home | Parent | ← Go → | Prior | Next |
When dealing with other applications, particularly when accessing web apps over the internet, and when performing automated operations for you as BookMacster can, well, “Errors Happen”.
When an error occurs, BookMacster displays an error dialog. At the bottom left is a button with a life-preserver icon. Clicking this button generates an email message including additional technical information, addressed to our Support team. If you would like our support regarding an error, don’t take a screenshot. Click the life-preserver icon.
Whenever BookMacster or one of its Workers generates an error, it is stored on your Macintosh User Account. You can re-view past errors by clicking in the menu BookMacster ▸ Logs and then clicking the Errors tab. Errors displayed in this manner likewise have a button with a life-preserver icon. Again, don’t take a screenshot. Click the life-preserver icon.
Although BookMacster generally provides quite informative error dialogs, there are a few that could benefit from further explanation. The remained of this page does that
Bookdog’s old Bookwatchdog runs in the background and, if so set, will jump in to your browsers’ bookmarks whenever any other process, such as BookMacster touches them. To prevent dogfights, at times, BookMacster asks Mac OS X for your Login Items, so it can see if Bookwatchdog is a Login Item, and if so remove it. Unfortunately, if the application required for any of your Login Items (not just Bookwatchdog) is missing, Mac OS X will give BookMacster an incomplete report. BookMacster then asks for your help to fix it. To get your help, BookMacster presents Broken Login Item Error 14470. Yes, it’s annoying, but it’s something that you should fix sooner or later anyhow. We’re just being helpful.
The instructions here look ominous, but following them will probably be the easiest thing you do all day. Here we go…
At the top left of your screen, click the Apple () menu down to System Preferences.
In the System row, click Users & Groups or Accounts
.
There are two tabs near to top. Click Login Items. You’ll see something like this…
Go back to the dialog in BookMacster and see which item number is broken.
Count down the list to that item number. In the example shown above, the item number is 2. Therefore we count down to the second item number and find that it is iTunesHelper. You will likely have different item number and a different item name.
If you know that you’re no longer using the item indicated, typically because it is associated with an app that you no longer use, skip the next two steps.
If you don’t recognize the item, put your mouse over the item and sit still for a few seconds. You may see a tooltip giving the path to the application /Applications/iTunes.app/Contents/Resources/iTunesHelper.app. If you don’t get any tooltip, and if the item’s ‘Kind’ is ‘Unknown’, it probably means that the item’s file or package has been deleted.
If you realize that you no longer need this item, skip this step. Otherwise, you should try and find or reinstall the missing item. This can be a little tricky if, as in the case of this example, the path is to an app which is inside another app. In this example, you would first navigate in Finder to /Applications, then see if you have iTunes application. If you don’t then indeed this is a Broken Login Item. If you do, then you must look inside the iTunes application package to see if you have Contents/Resources/iTunesHelper.app. To do this, perform a secondary click (“right-click”) on iTunes and click Show Package Contents. Open the Contents folder, then inside that open Resources and look for iTunesHelper. If it or any of its parent folders are not there, you’ve indeed got a Broken Login Item.
If the Broken Login Item is something that you no longer have or no longer use, re-activate the System Preferences ▸ Accounts window, select the item and click the [-] button to delete it. Of course, this item will not work any more, but it wasn’t working anyhow. If on the other hand you still want this item to work, you’ll need to reinstall it. You may need to visit its developer’s website and redownload it, or re-run the installer in the associated application.
Quit and re-launch BookMacster. This time you should not get the error message. (No news is good news.) This means that BookMacster has successfully received your Login Items from Mac OS X and verified that Bookwatchdog is not among them.
BookMacster installs add-ons into some web browsers in order to perform several functions. To do this legally, BookMacster signals Firefox or Chrome to install BookMacster’s extension, and then you must approve it by clicking a button or two in a dialog in Firefox or Chrome.
Usually it works, but if you don’t notice and/or respond to the dialog in Firefox or Chrome, or if Firefox or Chrome don’t display the dialog because they are occupied with some other task, Error 264948 will appear in BookMacster.
The process of installing extensions is complicated by the security hoops imposed by Chrome and Firefox. But you can never win an argument when the other side cries security. Don’t even try. Surrender is your only option.
Although BookMacster will retry the installation later when needed, it is often less frustrating, and thus recommended, if you’ve read this far, to fix the problem immediately, in a manual mode where you have more control. To do that,
The buttons are fairly self-explanatory, and if you want to stop reading now and start pushing buttons, go for it.
Focus on the row of buttons for the browser client for which the installation failed.
If indications are that the extension is installed, click the Test button and see what happens. You should get a green “passed the test” checkmark. Sometimes the test will fail because Firefox or Chrome were not running and take too long to launch. If that happens, click “Test” again. At other times, Firefox hangs and won’t quit. If that happens, type ⌘⎇esc and Force Quit Firefox.
Otherwise, click the Install button for one of the Chrome or Firefox Clients which you wish BookMacster to be able to work with. The Install button should be enabled after a failed test.
Activate Firefox or Chrome, and watch for instructions to appear. With Chrome, they hide a little Continue button in the status bar near the bottom of the window. With Firefox, sometimes it fails to respond when you click “Install Now” after the countdown. If that happens, wait a few seconds for BookMacster to display another error, then retry.
After installing, return to Manage Browser Extensions and click “Test”.
Repeat for other relevant clients.
The process is sometimes a bit of a wrestling match with Chrome and/or Firefox, but usually you can prevail, and in the end you will see happy green checkmark(s) as shown above.
| Home | Parent | ← Go → | Prior | Next |