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!
- @emeth- without whom this project would be impossible! This project utilises his massive database!
- @davep for helping me with textual.
- Everyone on the Catholic Diocese of Discord!
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.
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.
- Download a copy of the code from GitHub ( Follow this guide if you are unsure how to do this)
- Unzip this into a new folder ( Follow this windows guide if you are unsure how to do this).
- Install a copy of Python 3 (Head to python.org if you are unsure how to do this) . I'd recommend Python 3.9 or 3.10 if
you can, but any
Python >= 3.7
should work. - 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 unixsource ./venv/bin/activate
. - Type
pip install -r requirements.txt
- 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 namecommentaries.db
. - Run from your terminal window
python main.py
. - Enjoy!
If you want to compile your own binary, you can use pyinstaller
.
On Windows:
> pyinstaller --clean --onefile --add-data "main.css;." .\main.py
On Linux:
$ pyinstaller --clean --onefile --add-data "main.css:." .\main.py