Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

pcal

pcal is a fast, dependency-free terminal calendar for the Shahanshahi (Imperial Persian) calendar, inspired by the Unix cal command.

The Shahanshahi calendar shares the months and leap-year rules of the Solar Hijri (Jalali) calendar but counts years from the founding of the Persian Empire by Cyrus the Great — an offset of +1180 over Jalali (Jalali 1404 = Shahanshahi 2584).

This documentation is for pcal dev. See the releases for downloads, or try it live at pcal.nl.

Highlights

  • Single-month, three-month (-3), N-month (-n) and full-year (-y) views.
  • Today highlighted in reverse video.
  • Day-of-year (“Julian”) numbering with -j.
  • Full Persian-script mode (--persian / --fa): Persian month and weekday names and Eastern-Arabic digits, with correct bidirectional rendering.
  • Month input by number (5), romanized name (mordad), or Persian script (مرداد).
  • Week starts on Saturday, following Iranian convention.
  • Honors --no-color and the NO_COLOR environment variable.
  • Ships a man page and bash/zsh/fish completions. No runtime dependencies.

Continue to Installation to get started, or jump to the CLI reference generated directly from the source.