Skip to content

Repository files navigation

orthofetch

A terminal-based Orthodox Christian calendar made in a "fetch" style for Linux, showing today's saints, feasts, fasting, and readings.


Install

Run this one-liner:

/bin/sh -c "$(curl -fsSL https://raw.githubusercontent.com/daomah/orthofetch/main/install.sh)"

This will:

  • Copy the orthofetch script to ~/.local/bin
  • Copy the calendar data to ~/.local/share/orthofetch
  • Copy the bible data to ~/.local/share/orthofetch/bible

Make sure ~/.local/bin is in your PATH to run orthofetch from anywhere.


Usage

Daily Calendar

Simply run:

orthofetch

It will display today's Orthodox calendar entry in a neat, aligned format with the Orthodox cross.

orthofetch --reading [NUM]

This will give you the full text of a specific reading for today. So if you see [1] John 3.15-18 for example you will get those verses to read.

Bible Reading

orthofetch --bible

This will display all available Bible books organized by testament.

Updated Command Features:

  • Multi-word book support: --bible "1 Kings" 3.1-5 works perfectly
  • Format flexibility: Supports both dot (3.1-5) and colon (3:1-5) verse references
  • Complete reference options: Single verse, verse ranges, full chapters
  • Deuterocanonical support: --bible "4 Maccabees" and all deuterocanonical books
  • JSON-based structure: Fast loading from JSON files instead of text files
orthofetch --bible [BOOK]

This will list all chapters in the specified book (e.g., --bible John).

orthofetch --bible [BOOK] [CHAPTER]

This will display the full chapter (e.g., --bible John 3).

orthofetch --bible [BOOK] [CHAPTER]:[VERSE]

This will display a specific verse (e.g., --bible John 3:16).

orthofetch --bible [BOOK] [CHAPTER]:[VERSE]-[VERSE]

This will display a range of verses (e.g., --bible John 3:16-17).

Multi-word book names must be quoted:

orthofetch --bible "1 Kings" 3:1-5
orthofetch --bible "Wisdom of Solomon" 7

Random Verses

orthofetch --random-verse

This will display a random verse from anywhere in the Bible.

orthofetch --random-verse [BOOK]

This will display a random verse from the specified book (e.g., --random-verse Proverbs).

Display Options

orthofetch --no-color

This will take the color out of it making it plain text. This will also work with all other commands if you want to use it that way.


Tests

python3 -m unittest discover -s tests -v

Data

Books come from the JSON files from l1lsm0k13's AncientBible project.

Calendar comes from orthocal.

:)


License

BSD 2-Clause

About

A fetch utility for Orthodox Christians

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages