Provided by: orage_4.12.1-6_amd64 bug


       tz_convert - Timezone converter from operating system tz format into libical format used
       by Orage and several other calander tools.


       tz_convert [OPTION...] [INFILE]


       tz_convert is a command line tool, which can be used to convert timezone data from so
       called tz binary format, usually used in operating systems, to libical format, used by
       several calenders like Orage.

       There are several options available to only convert certain files or files in certain
       directory. Or only convert part of the file and ignore for example old data. It is also
       possible to add new timezone files, which are based on old timezone data.

       There are tools, which generate ical timezones data from tz source database, but those are
       often not available for normal users and are difficult to use. So often libical timezones
       are not up to date.  tz_convert reads directly the binary tz data and makes it possible to
       keep libical timezones up to date. The tool is mainly meant to be used by distro
       maintainers, but it should be easy and clear enough for all users.


       tz timezone files often can be found in directory /usr/share/zoneinfo. For example
       Europe/Helsinki. libical timezone files needs to be where you calendar can find them. For
       Xfce and Orage systems they are located under your Xfce directory in
       share/orage/libical/zoneinfo. For example Europe/Helsinki.ics. (use locate to find them.)


       -V, --version
           Print version information and exit.

       -?, --help
           Show this help message and exit.

           Show short usage summary.

       -i, --infile
           tz file name from operating system to convert from. If this is directory, all files in
           it are processed. Default is /usr/share/zoneinfo

       -o, --outfile
           ical timezone file name to be written. This can not be directory. It is meant to be
           used together with timezone parameter. This is very seldom used. Default is

       -m, --message
           debug message level. How much exra information is shown. 0 is least and 10 is highest
           (1=default). May give useful information when things do not work as expected.

       -l, --limit
           limit processing to newer than this year. Often there is a lot of old data available,
           which is not needed in normal day to day work and skipping unused years helps to
           improve performance. Default is to ignore older than year 1970 time changes.

       -t, --timezone
           timezone name to be used in the actual file. Normally file name is the same as
           timezone name, but if you want to create your own timezone, you need new file name,
           which contains some known timezone name. This is used together with outfile parameter.

       -r, --norecursive
           process only main directory, instead of all subdirectories. 0 = recursive 1 = only
           main directory (0=default).

       -c, --exclude count
           number of excluded directories. 5 = default (You only need this if you have more than
           5 excluded directories). This is used together with exclude parameter.

       -x, --exclude
           do not process this directory, skip it. You can give several directories with separate
           parameters. By default directories right and posix are excluded, but if you use this
           parameter, you have to specify those also. You need to use exclude count if you have
           more than 5 exclude directories.

       -u, --norrule
           do not use RRULE ical repeating rule, but use RDATE instead. Not all calendars are
           able to understand RRULE correctly with timezones. (Orage should work fine with
           RRULE). 0 = use RRULE 1 = do not use RRULE (0=default).


       Please report any bugs and enhancement requests to Note that
       tz_convert is part of orage so bugs are reported against orage and component tz_convert.
       Usage related questions can be sent to email list.



       tz_convert was written by Juha Kautto <>.

       This manual page was written by Juha Kautto <>.

                                            05/28/2009                              TZ_CONVERT(1)