Your comments

Hi, thanks for contacting us.

There is a C command-line interface (not a library). It is not designed to be used in a library context (global variables, places where the code calls die() or exit()) but you are welcome to take a look. 

To find the older C code, go back in the GitHub repository to the latest 4.x release 


https://github.com/hebcal/hebcal/tree/v4.31

I understand the desire to save money. iCalendar is going to be the highest fidelity calendar interchange format, but even 50 years later there are clearly reasons to keep using CSV.


For what it's worth, it looks like you can use a free Windows tool called Notepad++ to remove a Byte Order Mark.

https://www.ibm.com/support/pages/how-remove-bom-any-textxml-file

Hi Evan, sorry to hear you're still having difficulty with CSV files and Hebrew on Windows.

The best recommended calendar data interchange format is iCalendar. The CSV format dates back 1972 and precedes the introduction of Unicode. 50 years later, some programs continue to use it but as this thread helps to illustrate, it's still clunky and generally not international-aware.

It appears that the Events Calendar supports iCalendar import directly:

https://theeventscalendar.com/knowledgebase/k/importing-events-from-an-ics-file-with-event-aggregator/

Why not use iCalendar (which we offer) and avoid the hassle and inconsistencies caused by CSV?

Alternatively, since you have a copy of Excel on Windows, perhaps you could experiment with using it to remove the Byte Order Mark? 

1. Download the CSV file(s) from Hebcal

2. Open in Excel for Windows

3. Immediately use Excel's "Save As" feature to create a new CSV file (presumably without the Byte Order Mark)

4. Then import the new Hebrew CSV into The Events Calendar

Thanks for using Hebcal, and thanks for the feedback! We disabled the ArrowLeft/ArrowRight navigation on the Hebrew Date Converter as we agree it doesn't work well on a web page that has interactive forms.

Thanks for using the Hebcal Leyning API!

We don't have a centralized list of all of the parsha and holiday names, it's scattered in a few different places.

The English & Hebrew names of the regular parshiyot are included here in this JSON file:

https://github.com/hebcal/hebcal-leyning/blob/main/src/aliyot.json


Note that for regular parashat haShavua, we return a numerical field called parshaNum which can be used as a mapping key which may be more convenient than using the name field. Bereshit = 1, Noach = 2, etc.

The names used for holiday readings in English transliteration (such as Sukkot I) are included here:

https://github.com/hebcal/hebcal-leyning/blob/main/src/holiday-readings.json

And if you want Hebrew equivalents of the holiday names (such as סוּכּוֹת א׳), you will find them here:

https://github.com/hebcal/hebcal-es6/blob/main/po/he.po

Please let us know if this helps, and good luck with the API!

Glad it worked. Thanks for persevering through a cumbersome process.

Some day we hope to build and release an iPhone companion app... that would also make the install/re-install process easier.

Thanks for your reply. We can see from the screen shot that you're using the App Store on an iPhone, not the App Store on the Watch itself.

Because our app is Apple Watch Only and doesn't have an iPhone companion app, trying to install a 2nd time via the iPhone app store won't work. (Bad user experience on Apple's part to show you a greyed-out Purchased button, but it's a bit understandable because Watch-only apps are relatively new. I'm hoping Apple will probably eventually fix this.)


The recommended workaround is to install the Hebcal app from the App Store on the watch itself.


Press the Digital Crown to see the Home screen, then tap the App Store.

Then tap the Search box at the top, type Hebcal, and tap the Search button on the top right.

Then follow the instructions we posted earlier.

Thanks for using Hebcal Apple Watch app!

We're sorry to hear that you're having trouble installing the app on a new watch.

Press the Digital Crown to see the Home screen, then tap the App Store.

Then tap the Search box at the top, type Hebcal, and tap the Search button on the top right.


You should see a screen on the watch like the following:

If you've downloaded the Apple Watch Hebcal app before, you should see a blue cloud icon with an arrow pointing downwards (like the screen shot above). Or, you may see a small blue "GET" button if the watch thinks it's never been downloaded before.

Either way, click the blue cloud download icon (or the Get button) to download and install it on your watch.

Then click the blue Open button to launch the application.

If this doesn't work, could you try turning your watch off and then on again and see if it shows up correctly in the App Store?


If it still doesn't work, could you post a screenshot so we can see what it looks like on the Ultra?

Shabbat shalom!

Hi, thanks for using Hebcal. Sorry to hear you are having trouble with a personal yahrzeit calendar.


Just to clarify, these are the correct dates and conversion:

  • 9th of Kislev, 5782 = Sat, 13 November 2021
  • 9th of Kislev, 5783 = Sat, 3 December 2022

Can you send a screenshot showing your calendar and the incorrect dates?