bible-tui 0.6.0__tar.gz

bible_tui-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cody Sechelski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bible_tui-0.6.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: bible-tui
+Version: 0.6.0
+Summary: A dependency-free terminal Bible reader with Vim-style navigation and pluggable versions
+Author: Cody Sechelski
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/codysechelski/bible-tui
+Project-URL: Documentation, https://github.com/codysechelski/bible-tui/blob/main/docs/features/index.md
+Project-URL: Issues, https://github.com/codysechelski/bible-tui/issues
+Project-URL: Changelog, https://github.com/codysechelski/bible-tui/blob/main/CHANGELOG.md
+Keywords: bible,scripture,terminal,tui,curses,vim,kjv,reader
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Religion
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# bible-tui
+
+<p align="center">
+  <a href="https://github.com/codysechelski/bible-tui/releases"><img alt="Release" src="https://img.shields.io/github/v/release/codysechelski/bible-tui?sort=semver"></a>
+  <a href="https://github.com/codysechelski/bible-tui/actions/workflows/release.yml"><img alt="CI" src="https://github.com/codysechelski/bible-tui/actions/workflows/release.yml/badge.svg"></a>
+  <a href="https://github.com/codysechelski/bible-tui/blob/main/pyproject.toml"><img alt="Python 3.9+" src="https://img.shields.io/badge/python-3.9%2B-blue"></a>
+  <a href="https://github.com/codysechelski/bible-tui/blob/main/pyproject.toml"><img alt="Dependencies: none" src="https://img.shields.io/badge/dependencies-none-brightgreen"></a>
+</p>
+
+A fast, dependency-free terminal Bible reader with Vim-style keys.
+
+![bible-tui showing Genesis 1 with the books and chapters panes](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/main.png)
+
+- **[Read and navigate](https://github.com/codysechelski/bible-tui/blob/main/docs/features/navigation.md)** with arrows or Vim keys,
+  [jump to `John 3:16`](https://github.com/codysechelski/bible-tui/blob/main/docs/features/go-to-reference.md) with autocomplete, and use a Vim-style
+  [`:` command line](https://github.com/codysechelski/bible-tui/blob/main/docs/features/command-line.md).
+- **[Search](https://github.com/codysechelski/bible-tui/blob/main/docs/features/search.md)** within a chapter, or
+  [fuzzy-find across the whole Bible](https://github.com/codysechelski/bible-tui/blob/main/docs/features/fuzzy-find.md) with a live preview.
+- **[Compare two versions](https://github.com/codysechelski/bible-tui/blob/main/docs/features/split-view.md)** side by side, with verses lined up.
+- **[Mark](https://github.com/codysechelski/bible-tui/blob/main/docs/features/marks.md) and [highlight](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md)** verses in six colors. They're
+  saved and show in every version.
+- **[Bring any version](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md)**, in any language: each one is a SQLite file. The
+  public-domain KJV and ASV are included.
+
+| | |
+| --- | --- |
+| ![Highlight color picker](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/multi-color-highlighting.png) | ![List of highlights](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/showing-jump-list-of-highlights.png) |
+| [Highlight verses](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md) in six colors | [Jump back](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md) to any highlight or mark |
+| ![Version picker](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/supports-multiple-versions.png) | ![A Portuguese Bible](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/support-for-non-english-bibles.png) |
+| [Switch versions](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md) and keep your place | [Any language](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md#any-language) works |
+
+<sub>The Portuguese screenshot shows the Bíblia Livre (BLIVRE), copyright © 2018 Diego Santos, Mario Sérgio, and Marco Teles, from
+[eBible.org](https://ebible.org/porbr2018/copyright.htm), licensed under
+[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Not bundled with bible-tui.</sub>
+
+**[See all features →](https://github.com/codysechelski/bible-tui/blob/main/docs/features/index.md)** Each one has a short animation.
+
+## Install
+
+Requires Python 3.9+ on macOS or Linux, and nothing else.
+
+```sh
+pipx install git+https://github.com/codysechelski/bible-tui
+bible-tui
+```
+
+Or run it from a clone with `./bible-tui`.
+
+bible-tui checks for new releases once a day and tells you in the footer. Run `:update` to install the new
+version and restart where you were. To turn the check off, set `"check_for_updates": false` (see
+[update checks](https://github.com/codysechelski/bible-tui/blob/main/docs/configuration.md#update-checks)).
+
+## Usage
+
+```sh
+bible-tui                         # open the default version
+bible-tui asv                     # open a version by abbreviation
+bible-tui ~/my.sqlite             # open a database file directly
+bible-tui --bibles-dir ~/Bibles   # search an extra folder (repeatable)
+bible-tui --list-versions
+bible-tui --paths                 # show the config, state, and Bible folders in use
+```
+
+| Action | Keys |
+| --- | --- |
+| Move | arrows, or `h` `j` `k` `l` |
+| Next / previous chapter | `]` / `[` |
+| Go to a reference | `ctrl+g`, or `:John 3:16` |
+| Search the chapter / the whole Bible | `/` / `ctrl+s` |
+| Switch version | `t` |
+| Split to compare versions | `ctrl+w v` |
+| Mark / highlight a verse | `m` / `c` |
+| Copy the verse | `yy` |
+| All commands and keys | `ctrl+p` or `?` |
+| Quit | `q` |
+
+Every action also works without Vim keys. The full list is in [docs/keybindings.md](https://github.com/codysechelski/bible-tui/blob/main/docs/keybindings.md).
+
+## Adding versions
+
+Each version is one SQLite file. Copy a database into `~/.config/bible-tui/bibles/` and it appears in the
+version picker. To make one from a published Bible (USFM, USX, OSIS, and others), use
+[bible-tui-bible-converter](https://github.com/codysechelski/bible-tui-bible-converter). See
+[docs/adding-bibles.md](https://github.com/codysechelski/bible-tui/blob/main/docs/adding-bibles.md) for the steps, and
+[docs/bible-databases.md](https://github.com/codysechelski/bible-tui/blob/main/docs/bible-databases.md) for the schema.
+
+## Configuration
+
+`config.json` lives in the app home: `~/.bible-tui` if that folder exists, otherwise `~/.config/bible-tui` (or
+`$BIBLE_TUI_HOME`).
+
+```json
+{
+  "default_version": "KJV",
+  "bibles_dirs": ["~/Bibles"],
+  "book_order": "bible",
+  "nerd_font": false,
+  "remember_split": false,
+  "yank_format": "{text}"
+}
+```
+
+Every setting is described in [docs/configuration.md](https://github.com/codysechelski/bible-tui/blob/main/docs/configuration.md).
+
+## Development
+
+```sh
+python3 -m unittest discover -s tests -t .
+python3 -m py_compile bible_tui/*.py tests/*.py
+```
+
+Releases are automatic from [Conventional Commits](https://www.conventionalcommits.org/) on `main`: `fix:`
+releases a patch and `feat:` a minor version. See [CONTRIBUTING.md](https://github.com/codysechelski/bible-tui/blob/main/CONTRIBUTING.md) to get involved, and
+[ROADMAP.md](https://github.com/codysechelski/bible-tui/blob/main/ROADMAP.md) for what's planned.
+
+## Bible texts
+
+The bundled KJV and ASV come from [eBible.org](https://ebible.org) and are in the public domain. Sources and
+notes are in [docs/bible-databases.md](https://github.com/codysechelski/bible-tui/blob/main/docs/bible-databases.md#bundled-versions).
+
+## Licence
+
+bible-tui is released under the [MIT License](https://github.com/codysechelski/bible-tui/blob/main/LICENSE). The bundled Bible texts are in the public domain.

bible_tui-0.6.0/README.md

@@ -0,0 +1,123 @@
+# bible-tui
+
+<p align="center">
+  <a href="https://github.com/codysechelski/bible-tui/releases"><img alt="Release" src="https://img.shields.io/github/v/release/codysechelski/bible-tui?sort=semver"></a>
+  <a href="https://github.com/codysechelski/bible-tui/actions/workflows/release.yml"><img alt="CI" src="https://github.com/codysechelski/bible-tui/actions/workflows/release.yml/badge.svg"></a>
+  <a href="https://github.com/codysechelski/bible-tui/blob/main/pyproject.toml"><img alt="Python 3.9+" src="https://img.shields.io/badge/python-3.9%2B-blue"></a>
+  <a href="https://github.com/codysechelski/bible-tui/blob/main/pyproject.toml"><img alt="Dependencies: none" src="https://img.shields.io/badge/dependencies-none-brightgreen"></a>
+</p>
+
+A fast, dependency-free terminal Bible reader with Vim-style keys.
+
+![bible-tui showing Genesis 1 with the books and chapters panes](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/main.png)
+
+- **[Read and navigate](https://github.com/codysechelski/bible-tui/blob/main/docs/features/navigation.md)** with arrows or Vim keys,
+  [jump to `John 3:16`](https://github.com/codysechelski/bible-tui/blob/main/docs/features/go-to-reference.md) with autocomplete, and use a Vim-style
+  [`:` command line](https://github.com/codysechelski/bible-tui/blob/main/docs/features/command-line.md).
+- **[Search](https://github.com/codysechelski/bible-tui/blob/main/docs/features/search.md)** within a chapter, or
+  [fuzzy-find across the whole Bible](https://github.com/codysechelski/bible-tui/blob/main/docs/features/fuzzy-find.md) with a live preview.
+- **[Compare two versions](https://github.com/codysechelski/bible-tui/blob/main/docs/features/split-view.md)** side by side, with verses lined up.
+- **[Mark](https://github.com/codysechelski/bible-tui/blob/main/docs/features/marks.md) and [highlight](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md)** verses in six colors. They're
+  saved and show in every version.
+- **[Bring any version](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md)**, in any language: each one is a SQLite file. The
+  public-domain KJV and ASV are included.
+
+| | |
+| --- | --- |
+| ![Highlight color picker](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/multi-color-highlighting.png) | ![List of highlights](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/showing-jump-list-of-highlights.png) |
+| [Highlight verses](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md) in six colors | [Jump back](https://github.com/codysechelski/bible-tui/blob/main/docs/features/highlights.md) to any highlight or mark |
+| ![Version picker](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/supports-multiple-versions.png) | ![A Portuguese Bible](https://raw.githubusercontent.com/codysechelski/bible-tui/main/docs/screenshots/images/support-for-non-english-bibles.png) |
+| [Switch versions](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md) and keep your place | [Any language](https://github.com/codysechelski/bible-tui/blob/main/docs/features/versions.md#any-language) works |
+
+<sub>The Portuguese screenshot shows the Bíblia Livre (BLIVRE), copyright © 2018 Diego Santos, Mario Sérgio, and Marco Teles, from
+[eBible.org](https://ebible.org/porbr2018/copyright.htm), licensed under
+[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Not bundled with bible-tui.</sub>
+
+**[See all features →](https://github.com/codysechelski/bible-tui/blob/main/docs/features/index.md)** Each one has a short animation.
+
+## Install
+
+Requires Python 3.9+ on macOS or Linux, and nothing else.
+
+```sh
+pipx install git+https://github.com/codysechelski/bible-tui
+bible-tui
+```
+
+Or run it from a clone with `./bible-tui`.
+
+bible-tui checks for new releases once a day and tells you in the footer. Run `:update` to install the new
+version and restart where you were. To turn the check off, set `"check_for_updates": false` (see
+[update checks](https://github.com/codysechelski/bible-tui/blob/main/docs/configuration.md#update-checks)).
+
+## Usage
+
+```sh
+bible-tui                         # open the default version
+bible-tui asv                     # open a version by abbreviation
+bible-tui ~/my.sqlite             # open a database file directly
+bible-tui --bibles-dir ~/Bibles   # search an extra folder (repeatable)
+bible-tui --list-versions
+bible-tui --paths                 # show the config, state, and Bible folders in use
+```
+
+| Action | Keys |
+| --- | --- |
+| Move | arrows, or `h` `j` `k` `l` |
+| Next / previous chapter | `]` / `[` |
+| Go to a reference | `ctrl+g`, or `:John 3:16` |
+| Search the chapter / the whole Bible | `/` / `ctrl+s` |
+| Switch version | `t` |
+| Split to compare versions | `ctrl+w v` |
+| Mark / highlight a verse | `m` / `c` |
+| Copy the verse | `yy` |
+| All commands and keys | `ctrl+p` or `?` |
+| Quit | `q` |
+
+Every action also works without Vim keys. The full list is in [docs/keybindings.md](https://github.com/codysechelski/bible-tui/blob/main/docs/keybindings.md).
+
+## Adding versions
+
+Each version is one SQLite file. Copy a database into `~/.config/bible-tui/bibles/` and it appears in the
+version picker. To make one from a published Bible (USFM, USX, OSIS, and others), use
+[bible-tui-bible-converter](https://github.com/codysechelski/bible-tui-bible-converter). See
+[docs/adding-bibles.md](https://github.com/codysechelski/bible-tui/blob/main/docs/adding-bibles.md) for the steps, and
+[docs/bible-databases.md](https://github.com/codysechelski/bible-tui/blob/main/docs/bible-databases.md) for the schema.
+
+## Configuration
+
+`config.json` lives in the app home: `~/.bible-tui` if that folder exists, otherwise `~/.config/bible-tui` (or
+`$BIBLE_TUI_HOME`).
+
+```json
+{
+  "default_version": "KJV",
+  "bibles_dirs": ["~/Bibles"],
+  "book_order": "bible",
+  "nerd_font": false,
+  "remember_split": false,
+  "yank_format": "{text}"
+}
+```
+
+Every setting is described in [docs/configuration.md](https://github.com/codysechelski/bible-tui/blob/main/docs/configuration.md).
+
+## Development
+
+```sh
+python3 -m unittest discover -s tests -t .
+python3 -m py_compile bible_tui/*.py tests/*.py
+```
+
+Releases are automatic from [Conventional Commits](https://www.conventionalcommits.org/) on `main`: `fix:`
+releases a patch and `feat:` a minor version. See [CONTRIBUTING.md](https://github.com/codysechelski/bible-tui/blob/main/CONTRIBUTING.md) to get involved, and
+[ROADMAP.md](https://github.com/codysechelski/bible-tui/blob/main/ROADMAP.md) for what's planned.
+
+## Bible texts
+
+The bundled KJV and ASV come from [eBible.org](https://ebible.org) and are in the public domain. Sources and
+notes are in [docs/bible-databases.md](https://github.com/codysechelski/bible-tui/blob/main/docs/bible-databases.md#bundled-versions).
+
+## Licence
+
+bible-tui is released under the [MIT License](https://github.com/codysechelski/bible-tui/blob/main/LICENSE). The bundled Bible texts are in the public domain.

bible_tui-0.6.0/bible_tui/__init__.py

@@ -0,0 +1,3 @@
+"""A dependency-free terminal Bible reader."""
+
+__version__ = "0.6.0"

bible_tui-0.6.0/bible_tui/__main__.py

@@ -0,0 +1,3 @@
+from bible_tui.cli import main
+
+raise SystemExit(main())

bible_tui-0.6.0/bible_tui/cli.py

@@ -0,0 +1,339 @@
+"""Command line entry point: resolve paths and settings, pick a version, run the TUI."""
+
+from __future__ import annotations
+
+import argparse
+import curses
+import locale
+import os
+import sys
+from collections.abc import Mapping, Sequence
+from pathlib import Path
+
+from bible_tui import __version__
+from bible_tui.config import ConfigError, Settings, load_settings, load_state, save_state
+from bible_tui.highlights import HighlightStore
+from bible_tui.marks import MarkStore
+from bible_tui.update import (
+    RESTORE_POSITION_ENV,
+    UPDATED_FROM_ENV,
+    UpdateCheck,
+    detect_install,
+    format_position,
+    parse_position,
+    restart_command,
+)
+from bible_tui.paths import (
+    BIBLES_DIR_NAME,
+    BUNDLED_BIBLES_DIR,
+    CONFIG_FILE_NAME,
+    HIGHLIGHTS_FILE_NAME,
+    MARKS_FILE_NAME,
+    STATE_FILE_NAME,
+    home_candidates,
+    resolve_home,
+)
+from bible_tui.versions import (
+    BibleVersion,
+    Discovery,
+    VersionError,
+    discover_versions,
+    find_version,
+    inspect_database,
+)
+
+
+class CliError(Exception):
+    pass
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="bible-tui",
+        description="Browse the Bible in your terminal.",
+    )
+    parser.add_argument(
+        "bible",
+        nargs="?",
+        metavar="VERSION",
+        help="version to open: an abbreviation such as KJV, or a path to a .sqlite file",
+    )
+    parser.add_argument(
+        "-d",
+        "--bibles-dir",
+        action="append",
+        default=[],
+        type=Path,
+        metavar="DIR",
+        help="also load Bible databases from DIR (repeatable; searched before the defaults)",
+    )
+    parser.add_argument(
+        "-c",
+        "--config",
+        type=Path,
+        metavar="FILE",
+        help=f"use FILE instead of {CONFIG_FILE_NAME} in the app home",
+    )
+    parser.add_argument("-l", "--list-versions", action="store_true", help="list available versions and exit")
+    parser.add_argument("--paths", action="store_true", help="show where bible-tui looks for files and exit")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    return parser
+
+
+def bibles_search_path(home: Path, settings: Settings, extra_dirs: Sequence[Path]) -> list[Path]:
+    """Directories scanned for databases, highest priority first."""
+    return [
+        *(directory.expanduser() for directory in extra_dirs),
+        *settings.bibles_dirs,
+        home / BIBLES_DIR_NAME,
+        BUNDLED_BIBLES_DIR,
+    ]
+
+
+def choose_version(
+    discovery: Discovery,
+    requested: str | None,
+    settings: Settings,
+    state: Mapping[str, object],
+) -> tuple[BibleVersion, list[str]]:
+    """Pick the version to open: the command line, then ``default_version``, then the
+    last version used, then the first available."""
+    warnings: list[str] = []
+    versions = discovery.versions
+    if requested:
+        version = find_version(versions, requested)
+        if version is None:
+            available = ", ".join(v.abbreviation for v in versions) or "none"
+            raise CliError(f"unknown version {requested!r} (available: {available})")
+        return version, warnings
+    if settings.default_version:
+        version = find_version(versions, settings.default_version)
+        if version is not None:
+            return version, warnings
+        warnings.append(f"default_version {settings.default_version!r} not found; ignoring it")
+    last = state.get("last_version")
+    if isinstance(last, str):
+        version = find_version(versions, last)
+        if version is not None:
+            return version, warnings
+    if not versions:
+        raise CliError("no Bible databases found (run `bible-tui --paths` to see where to put them)")
+    return versions[0], warnings
+
+
+def remembered_split(
+    settings: Settings,
+    state: Mapping[str, object],
+    versions: Sequence[BibleVersion],
+) -> tuple[str, BibleVersion] | None:
+    """The split to reopen at launch, when ``remember_split`` is on and its version still exists."""
+    from bible_tui.tui import SPLITS
+
+    if not settings.remember_split:
+        return None
+    split = state.get("split")
+    abbreviation = state.get("split_version")
+    if split not in SPLITS or not isinstance(abbreviation, str):
+        return None
+    version = find_version(versions, abbreviation)
+    return (split, version) if version is not None else None
+
+
+def describe(path: Path) -> str:
+    home = str(Path.home())
+    text = str(path)
+    return "~" + text[len(home) :] if text == home or text.startswith(home + os.sep) else text
+
+
+def print_paths(home: Path, config_path: Path, search_path: Sequence[Path], env: Mapping[str, str]) -> None:
+    def status(path: Path) -> str:
+        return "" if path.exists() else "  (missing)"
+
+    print("App home lookup (first existing wins):")
+    for candidate in home_candidates(env):
+        marker = "*" if candidate == home else " "
+        print(f"  {marker} {describe(candidate)}{status(candidate)}")
+    print(f"\nConfig:     {describe(config_path)}{status(config_path)}")
+    state_path = home / STATE_FILE_NAME
+    print(f"State:      {describe(state_path)}{status(state_path)}")
+    marks_path = home / MARKS_FILE_NAME
+    print(f"Marks:      {describe(marks_path)}{status(marks_path)}")
+    highlights_path = home / HIGHLIGHTS_FILE_NAME
+    print(f"Highlights: {describe(highlights_path)}{status(highlights_path)}")
+    print("\nBible folders (earlier folders win when versions share a name):")
+    for index, directory in enumerate(search_path, 1):
+        print(f"  {index}. {describe(directory)}{status(directory)}")
+
+
+def print_versions(discovery: Discovery, current: BibleVersion | None) -> None:
+    if not discovery.versions:
+        print("No Bible databases found.")
+    width = max((len(version.abbreviation) for version in discovery.versions), default=0)
+    for version in discovery.versions:
+        marker = "*" if version == current else " "
+        name = version.name if version.name != version.abbreviation else ""
+        print(f"{marker} {version.abbreviation.ljust(width)}  {name}".rstrip())
+        print(f"  {' ' * width}  {describe(version.path)}")
+    if discovery.skipped:
+        print("\nSkipped:")
+        for path, reason in discovery.skipped:
+            print(f"  {describe(path)}: {reason}")
+
+
+def run_tui(
+    version: BibleVersion,
+    versions: Sequence[BibleVersion],
+    settings: Settings,
+    home: Path,
+    state: dict[str, object],
+    marks: MarkStore,
+    highlights: HighlightStore,
+    warnings: Sequence[str] = (),
+    notice: str = "",
+    position: tuple[int, int, int] | None = None,
+    restart_args: Sequence[str] = (),
+) -> None:
+    from bible_tui.store import BibleStore
+    from bible_tui.tui import MESSAGE_UPDATE, BibleTui
+
+    def remember(chosen: BibleVersion) -> None:
+        state["last_version"] = chosen.abbreviation
+        save_state(home, state)
+
+    def remember_split(split: str | None, split_version: BibleVersion | None) -> None:
+        if not settings.remember_split:
+            return
+        if split is None or split_version is None:
+            state.pop("split", None)
+            state.pop("split_version", None)
+        else:
+            state["split"] = split
+            state["split_version"] = split_version.abbreviation
+        save_state(home, state)
+
+    update_check = None
+    if settings.check_for_updates:
+        update_check = UpdateCheck(__version__, state, save=lambda: save_state(home, state))
+        update_check.start()
+    restart = ""  # The position to reopen at, once :update asks for a restart.
+
+    def run(stdscr: curses.window) -> None:
+        nonlocal restart
+        app = BibleTui(
+            stdscr,
+            BibleStore(version.path),
+            version,
+            versions,
+            alphabetical=settings.book_order == "alphabetical",
+            on_version_change=remember,
+            on_split_change=remember_split,
+            marks=marks,
+            highlights=highlights,
+            nerd_font=settings.nerd_font,
+            yank_format=settings.yank_format,
+            update_check=update_check,
+            install=detect_install(),
+        )
+        split = remembered_split(settings, state, versions)
+        if split is not None:
+            app.open_split(*split, restoring=True)
+        if position is not None:
+            app.jump_to_key(position)
+        if warnings:
+            app.show_error(f"warning: {warnings[0]}")
+        elif notice:
+            app.set_message(notice, MESSAGE_UPDATE)
+        try:
+            app.run()
+        finally:
+            app.close()
+        if app.restart_requested:
+            restart = format_position(app.restart_position) or "-"
+
+    curses.wrapper(run)
+    if restart:
+        # Replace this process with the updated code. The new one says what changed and reopens here.
+        command = restart_command(restart_args)
+        sys.stdout.flush()
+        os.execve(command[0], command, {**os.environ, UPDATED_FROM_ENV: __version__, RESTORE_POSITION_ENV: restart})
+
+
+def update_notice(env: Mapping[str, str]) -> str:
+    """After ``:update`` restarts the app, say whether the version changed."""
+    previous = env.get(UPDATED_FROM_ENV)
+    if not previous:
+        return ""
+    if previous == __version__:
+        return f"bible-tui {__version__} is up to date"
+    return f"updated bible-tui {previous} to {__version__}"
+
+
+def main(argv: Sequence[str] | None = None, env: Mapping[str, str] | None = None) -> int:
+    env = os.environ if env is None else env
+    argv = list(sys.argv[1:] if argv is None else argv)
+    args = build_parser().parse_args(argv)
+    try:
+        home = resolve_home(env)
+        if args.config is not None and not args.config.exists():
+            raise CliError(f"config file not found: {args.config}")
+        config_path = args.config if args.config is not None else home / CONFIG_FILE_NAME
+        settings = load_settings(config_path, env)
+        for warning in settings.warnings:
+            print(f"bible-tui: warning: {warning}", file=sys.stderr)
+        search_path = bibles_search_path(home, settings, args.bibles_dir)
+
+        if args.paths:
+            print_paths(home, config_path, search_path, env)
+            return 0
+
+        discovery = discover_versions(search_path)
+        if args.bible and Path(args.bible).expanduser().is_file():
+            try:
+                opened = inspect_database(Path(args.bible).expanduser())
+            except VersionError as error:
+                raise CliError(f"{args.bible}: not a usable Bible database ({error})") from None
+            others = tuple(v for v in discovery.versions if v.abbreviation.casefold() != opened.abbreviation.casefold())
+            discovery = Discovery((opened, *others), discovery.skipped)
+            args.bible = opened.abbreviation
+
+        state = load_state(home)
+        if args.list_versions:
+            current = None
+            try:
+                current, _ = choose_version(discovery, args.bible, settings, state)
+            except CliError:
+                pass
+            print_versions(discovery, current)
+            return 0
+
+        version, choice_warnings = choose_version(discovery, args.bible, settings, state)
+        for warning in choice_warnings:
+            print(f"bible-tui: warning: {warning}", file=sys.stderr)
+        marks = MarkStore.load(home)
+        if marks.load_error:
+            choice_warnings.append(f"marks are read-only until this is fixed: {marks.load_error}")
+            print(f"bible-tui: warning: {choice_warnings[-1]}", file=sys.stderr)
+        highlights = HighlightStore.load(home)
+        if highlights.load_error:
+            choice_warnings.append(f"highlights are read-only until this is fixed: {highlights.load_error}")
+            print(f"bible-tui: warning: {choice_warnings[-1]}", file=sys.stderr)
+        warnings = [*settings.warnings, *choice_warnings]
+    except (CliError, ConfigError) as error:
+        print(f"bible-tui: {error}", file=sys.stderr)
+        return 1
+
+    locale.setlocale(locale.LC_ALL, "")
+    run_tui(
+        version,
+        discovery.versions,
+        settings,
+        home,
+        state,
+        marks,
+        highlights,
+        warnings,
+        notice=update_notice(env),
+        position=parse_position(env.get(RESTORE_POSITION_ENV)),
+        restart_args=argv,
+    )
+    return 0