About

The About dialog box provides an overview of the installed version and update checks.

Open it via the application menu (logo, title, or chevron) → About. The action palette has the same Check for updates / Update available (version) / Restart to update (version) command as the logo menu; the Check weekly switch stays here.

Contents

  • About Bible Index and the Version {version} line
  • Check weekly — enables or disables automatic checks
  • Check for updates — manual check
  • Licenses — open-source license texts
  • bibleindex.app link

When the first weekly check is prompted, the text explains that the check only contacts dl.bibleindex.app and does not send any analytics or identifiers. Respond with Yes or No.

Weekly checks run silently in the background. If you are already up to date, nothing is shown. When a newer version is found, a dot appears on the app logo in the title bar, the application menu lists Update available (version), and About shows that version under Check for updates. Open that menu entry to install it or to open the download page. The update dialog and About also offer What's new, which opens the release notes for that version on bibleindex.app.

Check for updates in About always tells you the result: newer version, up to date (with your installed version), or failure.

Install an update

On a Linux AppImage, Install update downloads the new file, checks it, and replaces the AppImage where it already is. Then choose Restart now or Later. Until you restart, the application menu says Restart to update (version).

A Windows per-user install, a Windows portable copy on the same drive as your data folder, and a writable macOS install (installed under your Applications folder or a normal portable copy) work the same way from Install update.

The dialog keeps Visit the download page when the target folder cannot be written, there is not enough free space, a Linux portable archive is involved, a Windows portable copy stores data on another drive, or macOS opened the app from a download or disk image (App Translocation). The Linux developer install under ~/.local/opt/bibleindex also stays on the download page.

An AppImage manager is optional. Gear Lever is an easier way to use the AppImage: one click adds it to the application menu, and it installs later versions from the update information inside the file. Install update stays available when Gear Lever manages the file. After an update from inside Bible Index, Gear Lever can keep showing the old version until it rewrites its own launcher.

Other managers that follow the official AppImage update information work the same way. AppImageLauncher and appimageupdatetool are examples. Gear Lever is the one whose source was checked.

Check a Linux download

Linux downloads are signed with an OpenPGP key. The AppImage contains the signature. The portable .tar.gz has a sibling file with the same name plus .asc.

The official primary key fingerprint is CBDB784F4B0BC79D85C336BAC545A463093A2817.

From a copy of the BibleIndex source repository:

bash tool/release/verify-linux-release.sh \
  --fingerprint CBDB784F4B0BC79D85C336BAC545A463093A2817 \
  path/to/BibleIndex-VERSION-linux-x64.AppImage \
  path/to/BibleIndex-VERSION-linux-x64-portable.tar.gz

Replace VERSION with the release version, such as 1.2.0. The .asc file must be in the same directory as the .tar.gz. The command does not start the AppImage. It accepts the files only when the signature was made by the key with that fingerprint. To check the portable archive without the AppImage, add --key tool/release/BibleIndex-signing-key.asc.

See also