A TUI for reading the Church Fathers
  • Python 96.6%
  • CSS 3.4%
Find a file
dependabot[bot] 8cc66796fb
Some checks failed
Python package / build (windows-latest, 3.14) (push) Waiting to run
Python package / build (ubuntu-latest, 3.14) (push) Failing after 30s
build(deps-dev): bump pyinstaller from 6.20.0 to 6.22.3 (#31)
Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 6.20.0 to 6.22.3.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v6.20.0...v6.22.3)

---
updated-dependencies:
- dependency-name: pyinstaller
  dependency-version: 6.22.3
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-09-16 06:43:31 +01:00
.github build: add dependabot 2026-03-11 12:25:23 +00:00
.idea Textualize Boilerplate 2023-06-27 14:35:02 +01:00
catena_vetus refactor: simplify and optimise markdown building 2025-06-21 16:57:19 +01:00
tests refactor(tests): move unittest to pytest 2025-06-21 13:27:51 +01:00
.gitignore style: apply pre-commit for black 2025-06-21 15:05:02 +01:00
.pre-commit-config.yaml style: apply pre-commit for black 2025-06-21 15:05:02 +01:00
.whitesource style: apply pre-commit for black 2025-06-21 15:05:02 +01:00
LICENSE docs: move license to root 2025-06-21 16:01:59 +01:00
poetry.lock build(deps-dev): bump pyinstaller from 6.20.0 to 6.22.3 (#31) 2026-09-16 06:43:31 +01:00
pyproject.toml build(deps-dev): bump pyinstaller from 6.20.0 to 6.22.3 (#31) 2026-09-16 06:43:31 +01:00
README.md docs: correct test running 2025-08-30 17:42:29 +01:00

Catena Vetus

A Terminal User Interface frontend for Historical Christian Commentaries which does not require an internet connection. This software is best used with a mouse, if you intend to use the table of contents, otherwise a keyboard will serve you well!

asciicast of John 3:16

Commentaries on John 3:16

Screenshot showing the use of the table of contents

Credits

Setup

I'd thoroughly recommend you use a powerful terminal for this. Your default system one probably won't be the best experience. On Windows, go ahead and get a copy of Windows Terminal. On Linux, get a copy of Alacritty.

Pre-made binaries

If you are windows you can download the pyinstaller exe file and the database file from the releases page. Place these in the same folder (make sure the database file is called commentaries.db). Then open a Powershell window (preferably use Windows Terminal because it will work far better) in the same directory and execute the exe.

Running with classical Python tools

  1. Download a copy of the code from GitHub ( Follow this guide if you are unsure how to do this)
  2. Unzip this into a new folder ( Follow this windows guide if you are unsure how to do this).
  3. Install a copy of Python 3 (Head to python.org if you are unsure how to do this) . You need a version >=3.9.
  4. Open a terminal and head to the folder you downloaded this software to. Run python -m venv venv and then if you are on Windows .\venv\Scripts\activate and if on unix source ./venv/bin/activate.
  5. Type pip install -e .
  6. Either download the database from the releases page or compile your own. Move the database file to be in the same folder as main.py with the name commentaries.db.
  7. Run from your terminal window python main.py.
  8. Enjoy!

Developers

This section of the guide presumes thorough knowledge of the Python ecosystem.

pipx install poetry
pipx inject poetry poetry-pyinstaller-plugin
Building a binary
poetry build

The compiled software will be available under ./dist/.

Running the tests
poetry run pytest
Running the tests (classical)
pip install -e '.[dev]'
pytest