Files
Foundry/projects/khora/README.md
T
Gabriel Fontes 1d21154a47 feat(projects/khora): scaffold graphical vdir calendar
Add a read-only GTK/libadwaita agenda backed by khal, with calendar
filters, Nix packaging, desktop metadata, and model tests.

Assisted-by: pi (gpt-5.6-sol)
2026-08-15 12:23:27 -03:00

1.0 KiB

Khora

Khora is a graphical calendar for local vdirs. It uses khal for configuration, indexing, recurrence expansion, and iCalendar semantics; vdirsyncer remains in charge of talking to CalDAV servers.

Status

Khora is an early, read-only prototype. It currently provides:

  • a native GTK 4/libadwaita interface;
  • calendar discovery from the existing khal configuration;
  • per-calendar visibility controls;
  • a day agenda with recurring and all-day events; and
  • explicit refreshes of khal's local index.

Editing, week and month views, event details, and filesystem monitoring come next. The khal dependency is isolated in khora.khal_adapter so its internal API can change without leaking through the application.

Development

Build and run it from the Foundry root:

nix build .#khora
nix run .#khora

Khora reads the same XDG configuration and vdirs as khal. It does not configure accounts or perform network synchronization.

License

BSD 2-Clause