Upgrading BookHound 8 on MacOS

Step 1: Download the update

Download BookHound-Mac-Update.zip from Dropbox. See intro for how to receive a link.

Step 2: Move the file into your BookHound 8 folder

For most users, this folder is at Applications > BookHound 8. If you have a custom installation or have moved the application, the folder may be somewhere else, such as your Desktop.

Drag the downloaded file into your BookHound 8 folder. Don't unzip it yet. You'll first rename your current version so you can roll back if needed.

Step 3: Rename the current application

In your BookHound 8 folder, find the BookHound.app file and rename it to BookHound-Old.app.

Your Mac may hide the .app extension, so the file may simply appear as BookHound. It's usually the only file with that name. If you'd like to see extensions, open Finder and choose Finder > Settings > Advanced > Show all filename extensions.

Step 4: Unzip the update

Right-click BookHound-Mac-Update.zip and choose Open With > Archive Utility. This creates a new BookHound.app in the same folder.

Step 5: Launch BookHound 8

Double-click the new BookHound application. If it opens normally, you're done. If you see either of the alerts below, follow the steps for that alert.

Troubleshooting

"The application cannot be opened because it's from an unidentified developer"

1. Choose Apple menu > System Settings, then click Privacy & Security in the sidebar.
2. Scroll down to the Security section. You'll see a message saying BookHound was blocked. Click Open Anyway. This button is available for about an hour after you try to open the app.
3. Enter your Mac login password, then click OK.
4. Launch BookHound 8 again.

"The Primary file 'Data' cannot be found"

1. Click Cancel to close the alert.
2. Hold down the Option key and drag the BookHound application icon onto your Desktop. This creates a copy.
3. Drag the copy from your Desktop back into your BookHound 8 folder. When asked whether to replace the existing file, click Replace.
4. Launch BookHound 8 again.

---

Changes and things to check

Structurally, I removed the duplicated troubleshooting block (the original repeated both alerts twice), moved the Sonoma/Sequoia warning from the bottom to the top where people will see it before they start, and fixed typos ("extenstion," "is is," "appplication," "many receive," "theOpen," a stray "=").

A few things need your judgment:

1. Zip file name. Step 1 said BookHound-Mac-Update.zip but Step 4 said BookHound.zip. I used the first one everywhere; change it if the actual file is named differently.
2. "Intel based Mac." The original says BookHound keeps working on an Intel Mac as long as you don't upgrade to a version without Rosetta. Rosetta only runs on Apple Silicon Macs, where it translates Intel apps, so that sentence may really mean "your Mac" or "this Intel-based application." I wrote "your Mac," but you know the audience better.
3. Gatekeeper steps. The original's "Go to Security, then click Open" was garbled, so I rewrote it to match Apple's current flow. I also dropped the right-click > Open workaround, because Apple removed that shortcut in Sequoia. It still works on Sonoma, so you could add it back as a Sonoma-only tip.
4. Title vs. URL. The page title says "Upgrading" but the URL slug says "installing." It's minor, but worth aligning if your CMS makes that easy.