Repository files navigation

Cal (or fCal on SNAP) is a command line utility that will output a calendar for the desired month/year. It's simple and accurate with a few useful features.

By default, Cal will display the current year. You can provide a month and year, a month, or just a year. You can also change the number of calendars per row in your display with the-n switch. See the examples below for a more through description.

Cal also will show local holidays for many countries. It's activated via the-d switch. A list of supported countries can be found athttps://date.nager.at/Country

Parameters are the arguments provided to the program. They do not include the options above.

This is a java program that is all bundled into a single jar file. To run a jar file on the command line, simply type:

java -jar cal.jar

Please note that java must be in your path and this assumes cal.jar is in your current directory. Basic command line topics and I won't go into detail here.

I would encourage anyone with a supported Linux platform to use snap. SeeSnapcraft Homepage for more information. You can download, install, and keep Cal up to date automatically by installing the snap via :

sudo snap install fcal (Assuming snap is installed)

I had to call itfcal ascal was already taken.

This will install the application into a sandbox where it is separate from other applications. I do want to look at packaging it via Flatpak as well, but my understanding is that Maven is not well supported. However, I need to do more investigation.

I was able to use several web pages for sources of formulas for the program. These were very helpful and I'd like to thank their authors for taking the time to record them publicly.

Determine how to calculate the first day of a month given the month and year:

• https://www.tondering.dk/claus/cal/chrweek.php#calcdow
• http://www.cplusplus.com/forum/general/174165/

Calculate if the year provided is a leap year:

• https://www.wikihow.com/Calculate-Leap-Years

The MIT License

Copyright (C) 2019-2022 by Michael Fross

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.