ics2tsv.1 - ics2txt - convert icalendar .ics file to plain text
 (HTM) git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) Tags
 (DIR) 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 (iCalendar)
          146 .%R RFC 5545
          147 .Re
          148 .
          149 .
          150 .Sh AUTHORS
          151 .
          152 .An Josuah Demangeon Aq Mt me@josuah.net