cdates - Simple Terminal Calendar with Event Tracking

cdates is a lightweight command-line calendar that displays your schedule alongside a traditional monthly calendar. It uses a simple text file (caldates) to track events and highlights important dates directly in your terminal.

Features

• Shows current month; events include first week of next month
• Marks today and event days with *
• Reads events from plaintext caldates file
• Built-in editor flag (-edit) for quick access to caldates file
• Shows up to 12 events per view
• Lightning-fast execution

Installation

Download 'cdates' and 'caldates.txt' from:
https://640kb.neocities.org/apps/apps.html

Make executable and install

• chmod +x cdates
• sudo install cdates caldates /usr/local/bin

Usage

cdates          # Show current calendar with events
cdates -edit    # Edit events (sudo editorName /usr/local/bin/caldates)
cdates --help   # Show help menu

The caldates File Format

Events are stored in a simple text format:

<Month Abbr> <Day> <Event Description>

Example:

# Sample caldates file
Jan 1   New Year's Day
Mar 17  St. Patrick's Day Party
Apr 15  Tax Deadline!

Sample Output

+-----------------------------------------+
|                 Jun 2025                |
+-----+-----+-----+-----+-----+-----+-----+
| Sun | Mon | Tue | Wed | Thu | Fri | Sat |  Jun  1: Rent Due - $1600
+-----+-----+-----+-----+-----+-----+-----+  Jun  5: Team Building Event
|  1* |  2  |  3  |  4  |  5* |  6* |  7  |  Jun 10: Project Deadline
+-----+-----+-----+-----+-----+-----+-----+  Jun 15: Father's Day
|  8  |  9  | 10* | 11  | 12  | 13  | 14  |  Jun 21: Summer Solstice
+-----+-----+-----+-----+-----+-----+-----+  Jun 25: Payday - Debt Payment
| 15* | 16  | 17  | 18  | 19  | 20  | 21* |  Jun 30: Quarterly Planning
+-----+-----+-----+-----+-----+-----+-----+  Jul  1: Rent Due - $1700
| 22  | 23  | 24  | 25* | 26  | 27  | 28  |  Jul  4: Independence Day Fireworks
+-----+-----+-----+-----+-----+-----+-----+  Jul  7: Vacation Starts!
| 29  | 30* |     |     |     |     |     |
+-----+-----+-----+-----+-----+-----+-----+

Customization

Edit your events with:

cdates -edit

The system will open your caldates file in the default editor (xed). Change "xed" to whatever you want. Its location is at the bottom of the script. Search for:

"editor = "xed" # Hardcoded editor"

Note: The --edit option is the only option not compatible under Windows. Windows users will have to manually edit the 'caldates.txt' file

Uninstallation

sudo rm /usr/local/bin/cdates /usr/local/bin/caldates

License

This project is licensed under the Blue Oak Model License 1.0.0 View License

Why

I just wanted to do a calendar thingy one evening. A single month, a few reminders, 80 column width (more or less).

Note: The included caldates file contains a full year of sample events (2025). Simply edit or replace with your own events!

Testimonial

"Zero tracking. Zero syncing. Zero features. I’ll never use it. It’s like the dev ran out of time."
- 640kb.neocities.org (the dev)