Khal: Difference between revisions
From wikinotes
(→Usage) |
(→Config) |
||
(7 intermediate revisions by the same user not shown) | |||
Line 11: | Line 11: | ||
|- | |- | ||
| official docs || http://khal.readthedocs.org/en/latest/configure.html | | official docs || http://khal.readthedocs.org/en/latest/configure.html | ||
|- | |||
| github || https://github.com/pimutils/khal | |||
|- | |- | ||
|} | |} | ||
Line 19: | Line 21: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| <code>~/.config/khal/ | | <code>~/.config/khal/config</code> || config | ||
|- | |- | ||
|} | |} | ||
Line 27: | Line 29: | ||
<blockquote> | <blockquote> | ||
<source lang="bash"> | <source lang="bash"> | ||
sudo pip2 install khal | pacman -S khal # archlinux | ||
pkg install py38-khal # FreeBSD | |||
sudo pip2 install khal # other | |||
</source> | </source> | ||
</blockquote><!-- Install --> | </blockquote><!-- Install --> | ||
Line 33: | Line 37: | ||
= Usage = | = Usage = | ||
<blockquote> | <blockquote> | ||
< | {{ NOTE | | ||
khal agenda -a my_calendar | I wrote a wrapper function <code>cal</code> that uses cal-like date selection. | ||
khal calendar -a my_calendar | }} | ||
khal search party | <syntaxhighlight lang="bash"> | ||
ikhal # interactive calendar | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash"> | |||
khal # see calendar at now | |||
khal calendar at 2021-12-01T10:00pm # see calendar at datetime (in configured 'datetimeformat') | |||
khal calendar 2021-12-01T10:00pm | |||
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 | khal printcalendars # list available calendars | ||
khal import -a my_calendar file.ics # import event | khal import -a my_calendar file.ics # import event | ||
</syntaxhighlight> | |||
</ | |||
</blockquote><!-- Usage --> | </blockquote><!-- Usage --> | ||
Line 48: | Line 61: | ||
<blockquote> | <blockquote> | ||
Khal's config is fairly simple, simply choose a '''vdir''' | Khal's config is fairly simple, simply choose a '''vdir''' | ||
for a calendar, and choose the colour it should be displayed in. | for a calendar, and choose the colour it should be displayed in.<br> | ||
Khal's configuration is parsed using [[python configobj]], but you can also parse with builtin [[python configparser]]. | |||
<source lang="ini"> | <source lang="ini"> |
Latest revision as of 17:00, 2 October 2022
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 github https://github.com/pimutils/khal
Locations
~/.config/khal/config
config
Install
pacman -S khal # archlinux pkg install py38-khal # FreeBSD sudo pip2 install khal # other
Usage
NOTE:
I wrote a wrapper function
cal
that uses cal-like date selection.ikhal # interactive calendarkhal # see calendar at now khal calendar at 2021-12-01T10:00pm # see calendar at datetime (in configured 'datetimeformat') khal calendar 2021-12-01T10:00pm 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
Config
Khal's config is fairly simple, simply choose a vdir for a calendar, and choose the colour it should be displayed in.
Khal's configuration is parsed using python configobj, but you can also parse with builtin python configparser.# ~/.config/khal.conf [calendars] [[default]] path = ~/.calendars/default/ color = dark green [[work]] path = ~/.calendars/work/ color = #FFFFFF