Khal

Commandline calendar tool.
Supports CalDav. Loads calendars from vdir folders (inspired by mbox/maildir).

Khal depends on an external vcal server, and vdirsyncer. For a full setup see baikal for a VCal/VCard server, and vdirsyncer for instructions on setting up a vdir directory.

Documentation

official docs

http://khal.readthedocs.org/en/latest/configure.html

Locations

~/.config/khal/khal.conf

config

Install

sudo pip2 install khal

Usage

khal agenda   -a my_calendar        # prints events for that day
khal calendar -a my_calendar        # prints all calendars
khal search    party                # search all events for work 'party'

khal printcalendars                 # list available calendars
khal import -a my_calendar file.ics  # import event

ikhal                               # interactive calendar

Config

Khal's config is fairly simple, simply choose a vdir for a calendar, and choose the colour it should be displayed in.

# ~/.config/khal.conf
[calendars]
	[[default]]
		path  = ~/.calendars/default/
		color = dark green
	[[work]]
		path  = ~/.calendars/work/
		color = #FFFFFF