ttical.1 - ics2txt - convert icalendar .ics file to plain text
HTML git clone git://bitreich.org/ics2txt git://hg6vgqziawt5s4dj.onion/ics2txt
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR README
---
ttical.1 (1537B)
---
1 .Dd $Mdocdate: Mar 1 2020$
2 .Dt TICAL 1
3 .Os
4 .
5 .
6 .Sh NAME
7 .
8 .Nm tical
9 .Nd convert ics file to simpler tsv or txt formats
10 .
11 .
12 .Sh SYNOPSIS
13 .
14 .Nm tical-tsv Ar <file.ics >file.tsv
15 .Nm tical-ics Ar <file.tsv >file.ics
16 .Nm tical-txt Ar <file.tsv >file.txt
17 .Nm tical-back Ar <file.txt >file.tsv
18 .
19 .Sh DESCRIPTION
20 .
21 .Nm
22 is set of awk scripts to deal with iCal
23 .Pq Pa .ics
24 format to publish, display and convert *.ics files, though a simple
25 central TSV format.
26 .Pp
27 They all read from either stdin or the file passed as argument, and
28 write to stdout.
29 .
30 .Pp
31 .The
32 .Pa file.tsv
33 files have one line per event, all with the following fields,
34 separated by one tab:
35 .
36 .Bl -offset 1n -width 1n -enum -compact
37 .
38 .It
39 Begining (epoch)
40 .
41 .It
42 End (epoch)
43 .
44 .It
45 Category
46 .
47 .It
48 Location
49 .
50 .It
51 Summary
52 .
53 .It
54 Description
55 .
56 .El
57 .
58 .
59 .Sh EXAMPLES
60 .
61 Convert a calendar from HTTP
62 .Pa .ics
63 to custom
64 .Pa .txt
65 sorted by beginning:
66 .Dl curl "$url.ics" | tical-tsv | sort -n -k 1,1 | tcal-txt
67 .
68 .Pp
69 Convert a custom
70 .Pa .txt
71 format back to an
72 .Pa .ics
73 file and publish it:
74 .Dl tical-back cal.txt | tcal-ics | ssh "www@$host" 'cat >/var/www/cal.ics'
75 .
76 .Pp
77 Split an
78 .ics
79 file according to the category, saved as
80 .Pa .tsv :
81 .Dl tical-tsv cal.txt | awk -F '\et' '{ f = $3".tsv"; print >>f }'
82 .
83 .
84 .Sh SEE ALSO
85 .
86 .Xr cal 1 ,
87 .Xr calendar 1 ,
88 .Xr date 1 ,
89 .Xr sort 1
90 .
91 .
92 .Sh STANDARDS
93 .
94 .Rs
95 .%A Desruisseaux
96 .%D September 2009
97 .%T Internet Calendaring and Scheduling Core Object Specification (iCalendar)
98 .%R RFC 5545
99 .Re
100 .
101 .
102 .Sh AUTHORS
103 .
104 .An Josuah Demangeon Aq Mt me@josuah.net