Scal - Jalali (Shamsi) Calendar CLI

The Shamsi Calendar CLI is a straightforward command-line tool designed to display the Jalali (Shamsi) calendar in a terminal environment, much like the familiar Unix cal command. This utility is particularly beneficial for users who prefer the Shamsi calendar system and require a quick way to view dates.

Features

• Display Current Month: Easily view the current month in the Shamsi calendar with a single command.
• Specific Month and Year: Users can specify any month and year to view specific dates, allowing for flexibility in planning and scheduling.
• Multi-Month View: The tool can display three months at a time—previous, current, and next—offering a glance at upcoming dates.
• Full Year Display: Users can visualize an entire year's worth of dates in the Shamsi calendar format.

Usage Examples

Below are some basic command examples:

# Display current month
scal

# Display specific month
scal -m 4

# Display specific year
scal -y 1404

# Display specific month and year
scal -y 1404 -m 4

# Display three months (previous, current, next)
scal -3

# Display full year for the current year
scal -Y

Command Line Options

Here are the available command line options:

This tool not only simplifies the process of accessing the Shamsi calendar but also enhances productivity for users needing quick information at their fingertips.