Calenter

Calenter is a TUI frontend for calendar.txt inspired by Impala and Bluetui.

Building from Source

Run the following:

git clone https://github.com/jsypal04/Calenter.git
make

This command produces three artifacts: build/calenter, build/calenter-headless, and build/libcalenter.so. The first artifact is the app binary. The seconds artifact is a headless version of the app that is basically an entrypoint for libcalenter (for debugging purposes). The third artifact is a shared library containing the backend code (e.g., reading/writing to calendar.txt, parsing ics files, a custom array type, etc.).

To run the app without installing it use the following command.

make run

This sets the library paths properly before starting the app which prevents missing library issues.

Configuration

You may create a config file at ~/.config/calenter/config. It uses the following basic syntax:

key = value

Currently, there are only options to add a remote calendar and to configure notification settings. An example config is included below.

remote_url = <your gcal url>
enable_notifications = true
notify_time = 10

Notes on config options:

• remote_url should be a permalink to a .ics file
• enable_notifications is the master toggle for the notification daemon; if it is false, then the daemon will be stopped.
• notify_time is the amount of time in minutes before an event that the daemon will send a notification.

Installation

Run the following commands:

git clone https://github.com/jsypal04/Calenter.git
sudo make install

Feature List

This is a list of features I want to add.

• Ability to add all day events
• Repeat rules
  • Store event date-time data as a struct tm
  • Enable creating events with repeat rules.
  • Write algorithm to process BYxxx rules
• Multi-day all day events
• Native ics parser
• Ability for configuration (need to flesh this out)
  • Notifications
  • Colors
  • Layout
• Add cursors to input fields

Bug List

This is a list of known bugs.

1. If lines of an ICS file end in LF instead of CRLF it causes a seg fault
   • This is not really a bug since by the RFC, ICS file lines must end int CRLF but it would probably be good to add fault handling.
2. When the app launches the daemon process the terminal stays open after the app is closed.