Awesome

bibcal

A command-line calendar based on the Bible and the 1st Book of Enoch.

System requirements

There are pre-built binaries for recent version of any x86_64 OS listed below:

Linux
MacOS (it runs just fine on Apple Silicon using Rosetta 2)
Windows

There are also pre-built binaries for Apple Silicon, but these are built locally on my M1 Mac and not built automatically by Github.

The file bibcal-all.jar can be run by java on any OS:

$ java -jar /path/to/bibcal-all.jar [options]

Installation

MacOS

Download and unpack the binary from the latest release page. Move the binary to a reasonable location:

tar xvf bibcal-*-apple-darwin-x86_64.tar.gz
cp bibcal-*-apple-darwin-x86_64 /usr/local/bin/bibcal

Using the excellent xbar application you can create a Menu Bar plugin like this:

xbar bibcal plugin, minimized

Which expands to this: xbar bibcal plugin, on click

Use the example plugin or customize according to your needs. Make sure to save your coordinates and timezone to your configuration file first and verify that you get the expected results when running bibcal from the command line.

Windows

Windows users using the package manager Scoop can install bibcal from the scoop-clojure bucket.

Linux

Arch Linux

Arch Linux users may install the package bibcal-bin from the AUR.

$ paru -S bibcal-bin

RPM based distributions

Linux distributions using RPM packages can find a freshly baked RPM on the latest release page.

DEB based distributions

Linux distributions using DEB packages can find a newly pressed DEB on the latest release page.

All supported operating systems

Download the latest pre-built binary archive, unpack it and place it somewhere on your PATH.

For Linux and MacOS users, you may need to make it executable:

cd /path/of/bibcal
$ chmod +x bibcal

Usage

The app is run from the command line.

Windows users can use either CMD or PowerShell and simply go to the directory where the file is located (if it's not already added to the PATH environment variable) and run ./bibcal.exe with any options following.

If you installed it using scoop you can run bibcal from any PowerShell terminal since it will automatically be added to your PATH.

Note to Windows users: double clicking bibcal.exe will do nothing useful.

Running bibcal without any options or arguments will print a list of feast days in the current gregorian year. Adding a year as an argument will print the feast days of that year.

Running bibcal with the option -D will print a short summary of the current biblical date.

Running bibcal with the option -d will print a slightly longer summary of the current biblical date.

Example:

$ bibcal -D

Result:

18th of Av

If you want to see the biblical date of a specific gregorian date, then add arguments at the end of the command representing year, month, day, hour, minute, and second (at least 3 positions).

Example:

$ bibcal -l -74.006111 -L 40.712778 -z America/New_York 2011 1 1 9 0

Result:

Date                    26th day of the 9th month
ISO date                6010-09-26
Traditional date        26th of Kislev
Traditional ISO date    5771-09-26
Day of week             7
Sabbath                 true
Major feast day         2nd day of Hanukkah
Local time              2011-01-01 09:00:00
Start of next day       2011-01-01 16:01:00

Run with option -v for a more verbose output, including the start and end of day, week, month, and year, as well as false values that would otherwise be omitted.

$ bibcal -v -l -74.006111 -L 40.712778 -z America/New_York 2011 1 1 9 0

Result:

Date                    26th day of the 9th month
ISO date                6010-09-26
Traditional date        26th of Kislev
Traditional ISO date    5771-09-26
Day of week             7
Sabbath                 true
Major feast day         2nd day of Hanukkah
Minor feast day         false
Local time              2011-01-01 09:00:00
Start of year           2010-04-14 09:09:00
Start of month          2010-12-06 15:46:00
Start of week           2010-12-25 15:59:00
Start of day            2010-12-31 15:58:00
End of day              2011-01-01 16:00:59
End of week             2011-01-01 16:00:59
End of month            2011-01-04 16:03:59
End of year             2011-04-03 10:16:59
Coordinates             -74.006111,40.712778
Timezone                America/New_York
Config file             /home/user/.config/bibcal/config.edn

Use bibcal -h to see a list of options and arguments.

Configuration file

To save your timezone, latitude and longitude, create a file ~/.config/bibcal/config.edn. If you are running Windows, the file would be C:\Users\USERNAME\AppData\Roaming\bibcal\config.edn. In it, save all or some of the following key-value pairs:

{:zone "Asia/Jerusalem"
 :lat 31.7781161
 :lon 35.233804}

This file can be generated for you by using the option -c together with the options that you want to save. Example:

$ bibcal -c --lat 31.7781161 --lon 35.233804 --zone Asia/Jerusalem

Acknowledgements

All calculations are provided by the luminary library.

Security

All releases are signed with the following key which is in turn signed with my master key, which is published at keybase.io:

License

ISC License

Copyright (c) 2021-2023, Johan Thorén

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Contributor Code of Conduct

This project adheres to No Code of Conduct. We are all adults. We accept anyone's contributions. Nothing else matters.

For more information please visit the No Code of Conduct homepage.