Crates.io | orgtoical |
lib.rs | orgtoical |
version | 0.1.0 |
source | src |
created_at | 2024-12-11 03:53:21.193449 |
updated_at | 2024-12-11 03:53:21.193449 |
description | Export org-mode files to iCalendar |
homepage | |
repository | https://codeberg.org/felipeqq2/orgtoical |
max_upload_size | |
id | 1479560 |
size | 40,922 |
#+TITLE: orgtoical
=org-mode= has a builtin [[https://orgmode.org/manual/iCalendar-Export.html][iCalendar export]]. It's horrifyingly slow with bigger files. And, apparently, it's not super hard to build. So, this is a very similar tool to handle your iCal exports, only a tad faster.
Quick comparison: using an org file with 1,3M and +20k lines, exporting this file via =org-icalendar-export-to-ics= takes around a very, very long time. Running cat vault.org | orgtoical takes 138.21ms.
=orgtoical= parses stdin as an org file, and outputs the iCalendar to stdout. Nice for piping and redirecting stuff! There are no command-line options.
iCal nonconformities Although =TIMEZONE= properties are supported, no timezone definitions are added to the output. This is the same behaviour as the org export, but is a nonconformity as per the [[https://www.rfc-editor.org/rfc/rfc5545][iCal spec]]. In my experience, consuming applications usually understand IANA timezone identifiers.
Support Currently, it supports the following properties: =TIMEZONE=, =LOCATION=, =DESCRIPTION=, =UID=. =SUMMARY= is the title of the headline, and =CATEGORIES= is a list of all tags assigned to the headline. Both properties and tags are inherited. Only calendar events are supported.