Troubleshooting

The problems people have hit so far, and what to do about each.

"The download permission ran out" or a daily limit

This is a Backblaze daily cap. Vox on your Mac now says which one, for example "Backblaze's daily download limit is reached". Older versions said "The download permission ran out" instead.

1. Check that your Backblaze account has a payment card. Without one, every cap stays at $0, so downloads stop after 1 GB a day.
2. Open Caps & Alerts and raise the caps. Vox recommends storage $0.10 a day (about 440 GB) and download $0.50 a day (about 51 GB).
3. Try again. If you leave the caps as they are, downloads start again after the cap resets at midnight UTC.

"Backblaze's daily storage limit is reached" means the storage cap is too low for your Library. Raise it in Caps & Alerts, then try again. Settings › Storage, under What it costs, says when your Library is larger than the recommended cap allows.

The web app shows an old version

When you are signed in, the web app asks before it updates. Look for A new version of Vox is ready. and tap Update. On the sign-in screen it updates by itself.

Your Mac asks for the Keychain password after an update

Vox keeps your keys in your Mac's Keychain. After an update, macOS may ask whether Vox Liberata can use them. Enter your Mac's login password and click Always Allow. If you click Allow, macOS asks again next time.

macOS will not open Vox

Vox is signed with a Developer ID but is not notarised yet. In Applications, right-click Vox Liberata and choose Open, then click Open. If there is no Open button, go to System Settings › Privacy & Security and click Open Anyway.

Setup stopped at Go online

Click Try again. Nothing is half set up, and Vox picks up where it stopped. If the same step fails again, click Copy report and send the report with your question.

Start over on a Mac

1. In Settings › Accounts, click Disconnect… next to your Audible store. This removes the Mac's device registration from your Amazon account.
2. For a Cloud Library, click Disconnect… under Your Library as well. Books already in your Library stay there.
3. Quit Vox from the menu bar with Quit Vox Liberata.
4. Move this folder to the Bin: ~/Library/Application Support/app.personallibrary.decoder. It holds Vox's settings and its record of your books. Your books folder is somewhere else and is not touched.
5. Open Vox again. Setup starts at Choose a setup.

To use the Library you already have on this Mac, you do not need setup. In the web app, open Account and choose Connect a Computer to make a code. Then in Vox, open Settings › Accounts and click Connect….

Getting help

Settings › Diagnostics has Copy report, which copies facts about your setup but none of your keys, and Show log in Finder.