carl

Carl is a command-line calendar application that serves as an enhanced replacement for the standard cal(1) utility. It provides the familiar calendar display functionality with additional features including color customization, iCal file integration, and configurable themes. Users can display single months, three-month views, or full-year calendars with various formatting options like Julian dates and configurable week start days.

The tool integrates with iCal files to highlight events directly in the calendar display and can show an agenda view listing all events in the displayed timespan. Carl supports extensive theming through TOML configuration files, allowing users to define custom styles for different date properties like weekdays, current date, events, and various calendar states. The styling system supports terminal colors, text formatting (bold, italic, underline), and can be configured for both light and dark terminal backgrounds.

Carl uses Jinja templates for output rendering, enabling complete customization of the calendar layout. Configuration is managed through XDG-compliant directories with support for theme files, iCal file specifications, and custom template directories. The tool is particularly useful for developers and terminal users who want calendar functionality integrated into their command-line workflow with visual event tracking and customizable appearance.

Installation

# via Cargo
cargo install carl