A command-line tool for fetching Orthodox Christian calendar data and generating iCal files. OrthoTerm provides easy access to daily saints, readings, and liturgical notes from the Orthodox calendar, with support for both Gregorian and Julian dates.
The calendar data is sourced from Holy Trinity Orthodox Church, which provides:
- Daily saints and commemorations
- Scripture readings from the Orthodox lectionary
- Troparia and kontakia
- Fasting guidelines
- Major feast days
Please note that this tool respects the source website by:
- Including appropriate delays between requests
- Implementing retry logic with exponential backoff
- Caching data locally to minimize server load
- Fetch Orthodox calendar data for any year
- Generate iCal files for calendar integration
- Support for both Gregorian and Julian calendar dates
- Local data storage using XDG base directories
- Automatic caching of calendar data
TODO: Add Nix installation instructions
- Ensure you have Rust installed via rustup
- Clone and build the repository:
git clone https://github.com/yourusername/orthoterm.git
cd orthoterm
cargo install --path .orthoterm
orthoterm 2025
orthoterm -i 2025
This project is licensed under the MIT License - see the LICENSE file for details.
[YEAR]: Optional. The year to fetch calendar data for (defaults to current year)-i: Generate an iCal file for the specified year
OrthoTerm stores its data in standard XDG directories:
- Calendar data:
~/.local/share/orthoterm/data/calendar_YEAR.json - iCal files:
~/.local/share/orthoterm/ical/calendar_YEAR.ics
The project includes a flake.nix for a reproducible development environment:
# Enter development shell
nix develop
# Now you can build and run
cargo build
cargo run- Install Rust via rustup
- Clone the repository:
git clone https://github.com/yourusername/orthoterm.git
cd orthoterm- Build and run:
cargo build
cargo runContributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.