···

       
2
       
2
       
 
       


     

       
3
       
3
       
 
       
Caledonia is a command-line calendar client.

     

       
4
       
4
       
 
       
Currently, it operates on a [vdir](https://pimutils.org/specs/vdir/) directory of [`.ics`](https://datatracker.ietf.org/doc/html/rfc5545) files (as managed by tools like [vdirsyncer](https://github.com/pimutils/vdirsyncer)).

     

       
5
       
5
       
-
       
It has the `list`, `search`, `show`, `add`, `delete`, and `edit` subcommands, and supports timezones.

     

       
5
       
5
       
+
       


     

       
6
       
6
       
+
       
It has the `list`, `search`, `show`, `add`, `delete`, and `edit` subcommands, and has full timezone support.

     

       
7
       
7
       
+
       


     

       
8
       
8
       
+
       
An example `list` invocation is,

     

       
9
       
9
       
+
       


     

       
10
       
10
       
+
       
```

     

       
11
       
11
       
+
       
$ caled list

     

       
12
       
12
       
+
       
054bb346-b24f-49f4-80ab-fcb6040c19a7                              personal   2025-04-04 Fri 13:00 - 14:00 (America/New_York) New York 8am meeting

     

       
13
       
13
       
+
       
3B84B125-6EFC-4E1C-B35A-97EFCA61110E                              family     2025-04-06 Sun 21:00 - 22:00 (UTC)              Family chat @Video call

     

       
14
       
14
       
+
       
4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d  work       2025-04-09 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting

     

       
15
       
15
       
+
       
ccef66cd4d1e87ae7319097f027f8322de67f758                          personal   2025-04-10 Thu 11:00 - 12:00 (UTC)              Dentist

     

       
16
       
16
       
+
       
3B84B125-6EFC-4E1C-B35A-97EFCA61110E                              family     2025-04-13 Sun 21:00 - 22:00 (UTC)              Family chat @Video call

     

       
17
       
17
       
+
       
33cf18ec-90d3-40f8-8335-f338fbdb395b                              personal   2025-04-15 Tue - 2025-04-17 Thu                 John Doe in town

     

       
18
       
18
       
+
       
8601c255-65fc-4bc9-baa9-465dd7b4cd7d                              personal   2025-04-15 Tue 21:00 - 21:30 (UTC)              Grandma call

     

       
19
       
19
       
+
       
4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d  work       2025-04-16 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting

     

       
20
       
20
       
+
       
7hm4laoadevr1ene8o876f2576@google.com                             personal   2025-04-19 Sat                                  Jane Doe's birthday

     

       
21
       
21
       
+
       
3B84B125-6EFC-4E1C-B35A-97EFCA61110E                              family     2025-04-20 Sun 21:00 - 22:00 (UTC)              Family chat @Video call

     

       
22
       
22
       
+
       
8601c255-65fc-4bc9-baa9-465dd7b4cd7d                              personal   2025-04-22 Tue 21:00 - 21:30 (UTC)              Grandma call

     

       
23
       
23
       
+
       
4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d  work       2025-04-23 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting

     

       
24
       
24
       
+
       
3B84B125-6EFC-4E1C-B35A-97EFCA61110E                              family     2025-04-27 Sun 21:00 - 22:00 (UTC)              Family chat @Video call

     

       
25
       
25
       
+
       
8601c255-65fc-4bc9-baa9-465dd7b4cd7d                              personal   2025-04-29 Tue 21:00 - 21:30 (UTC)              Grandma call

     

       
26
       
26
       
+
       
4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d  work       2025-04-30 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting

     

       
27
       
27
       
+
       
```

     

       
28
       
28
       
+
       


     

       
6
       
29
       
 
       
See [TODO](./TODO.org) for future plans.

     

       
7
       
30
       
 
       


     

       
8
       
31
       
 
       
## Configuration