ics2tsv.1 - ics2txt - convert icalendar .ics file to plain text | |
git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws… | |
Log | |
Files | |
Refs | |
Tags | |
README | |
--- | |
ics2tsv.1 (2162B) | |
--- | |
1 .Dd $Mdocdate: Mar 1 2020$ | |
2 .Dt ICS2TSV 1 | |
3 .Os | |
4 . | |
5 . | |
6 .Sh NAME | |
7 . | |
8 .Nm ics2tsv | |
9 .Nd convert an icalendar.ics file to tsv | |
10 . | |
11 . | |
12 .Sh SYNOPSIS | |
13 . | |
14 .Nm ics2tsv | |
15 .Op Fl 1 | |
16 .Op Fl f Ar fields | |
17 .Op Fl s Ar subsep | |
18 .Op Fl t Ar timefmt | |
19 .Ar [file.ics...] >file.tsv | |
20 . | |
21 .Sh DESCRIPTION | |
22 . | |
23 .Nm | |
24 is a converter that parse icalendar format and produces lines of output. | |
25 Every line represents an element delimited by | |
26 .Dq BEGIN: | |
27 and | |
28 .Dq END: | |
29 among | |
30 .Dq VEVENT , | |
31 .Dq VTODO , | |
32 .Dq VJOURNAL , | |
33 .Dq VFREEBUSY , | |
34 and | |
35 .Dq VALARM . | |
36 . | |
37 .Pp | |
38 The lines are filled with tab-delimited fields, with the first ones: | |
39 . | |
40 .Bl -enum | |
41 . | |
42 .It | |
43 Element type, as encountered after | |
44 .Dq BEGIN | |
45 and | |
46 .Dq END ; | |
47 . | |
48 .It | |
49 Start date, present for | |
50 .Dq VEVENT , | |
51 .Dq VJOURNAL , | |
52 .Dq VFREEBUSY , | |
53 and | |
54 .Dq VALARM | |
55 types. | |
56 . | |
57 .It | |
58 End date, present for | |
59 .Dq VEVENT , | |
60 .Dq VTODO , | |
61 .Dq VFREEBUSY , | |
62 and | |
63 .Dq VALARM | |
64 types. | |
65 . | |
66 .It | |
67 Reserved for future use. | |
68 . | |
69 .El | |
70 . | |
71 .Pp | |
72 And the other fields starting from | |
73 .Pq 5. | |
74 chosen by the | |
75 .Fl f | |
76 flag. | |
77 By default: | |
78 .Dq "CATEGORIES,LOCATION,SUMMARY,DESCRIPTION" . | |
79 . | |
80 .Bl -tag | |
81 . | |
82 .It Fl 1 | |
83 Show the name of the columns on the first line before the content. | |
84 . | |
85 .It Fl f Ar field1,field2,field3... | |
86 Chooses the fields from the icalendar to display, in this order, | |
87 separated by a comma | |
88 .Pq Sq \&, | |
89 and case-insensitive | |
90 . | |
91 .It Fl s Ar subsep | |
92 When there are multiple fields with the same value, they are | |
93 concatenated with | |
94 .Ar subsep | |
95 separator, by default a comma | |
96 .Pq Sq \&, . | |
97 . | |
98 .It Fl t Ar timefmt | |
99 Dates from 2nd and 3rd fields are formatted with a | |
100 .Xr strftime 3 | |
101 string | |
102 .Ar timeftm , | |
103 by default in seconds since 1970/01/01. | |
104 . | |
105 .El | |
106 . | |
107 . | |
108 .Sh ENVIRONMENT VARIABLES | |
109 . | |
110 .Bl -tag | |
111 . | |
112 .It TZ | |
113 Timezone to use for printing dates, as documented by | |
114 .Xr tzset 3 . | |
115 . | |
116 .El | |
117 . | |
118 . | |
119 .Sh EXAMPLES | |
120 . | |
121 .Pp | |
122 Split an | |
123 .ics | |
124 file according to the category, saved as | |
125 .Pa .tsv : | |
126 .Bd -literal | |
127 ics2tsv -f CATEGORIES icalendar.ics | awk -F '\et' '{ print >>($6".tsv")… | |
128 .Ed | |
129 . | |
130 . | |
131 .Sh SEE ALSO | |
132 . | |
133 .Xr cal 1 , | |
134 .Xr calendar 1 , | |
135 .Xr date 1 , | |
136 .Xr tsv2agenda 1 , | |
137 .Xr tzset 3 | |
138 . | |
139 . | |
140 .Sh STANDARDS | |
141 . | |
142 .Rs | |
143 .%A Desruisseaux | |
144 .%D September 2009 | |
145 .%T Internet Calendaring and Scheduling Core Object Specification (iCale… | |
146 .%R RFC 5545 | |
147 .Re | |
148 . | |
149 . | |
150 .Sh AUTHORS | |
151 . | |
152 .An Josuah Demangeon Aq Mt [email protected] |