Troubleshooting

Common issues and solutions

No modules appear in the Library

Make sure you've selected your modules folder using Choose Modules Folder in the Modules tab toolbar. Then click ↺ Refresh. The folder must contain .SQLite3 files with valid MyBible table structures.

A module appears in the wrong category

Module type is detected from the database structure. If a module is miscategorised, its info table description may be misleading the detector. You can rename the description field using a SQLite editor such as DB Browser for SQLite. Alternatively, contact the module author for a corrected version.

Cross-references show nothing

Make sure you have a cross-reference module installed and visible in the Modules tab. Select it using the picker in the Dictionary tab of the Companion Panel. Some modules only cover parts of the Bible.

Bible text looks garbled

Some older modules use encoding that differs from UTF-8. This is a known limitation of certain third-party modules and cannot be corrected within the app.

Notes aren't syncing

Notes sync via iCloud. Check that iCloud Drive is enabled in System Settings → Apple ID → iCloud. Make sure ScriptureStudy has iCloud access. Notes sync may take a few minutes after changes.

brIΛn isn't responding

Check that your AI engine is configured in Settings. If using Claude, verify your Anthropic API key is valid and has remaining credits. If using Ollama, make sure Ollama is running locally — click Refresh in the Ollama section of Settings to check the connection status.

Calendar events aren't showing in ToDo

Go to System Settings → Privacy & Security → Calendars and make sure Scripture Study has access. Toggle the Personal Calendar or Birthdays switches in the ToDo tab source strip to enable them.

The app icon isn't showing in the Dock

If running a development build from Xcode, the Dock icon may show as the default Xcode icon. Build a Release version and copy the .app to your Applications folder. If the icon still doesn't update, run killall Dock in Terminal.

Help files not found

This indicates the HelpPages folder wasn't included in the app bundle. In Xcode, check that HelpPages appears in Build Phases → Copy Bundle Resources as a blue folder reference, and rebuild.