TIMEW-IMPORT(1) User Manuals TIMEW-IMPORT(1)

NAME

timew-import - import time-tracking data from files

SYNOPSIS

timew import [<file>...]

DESCRIPTION

Import tracked time from file. If no files are specified, the
command will read from standard input.

The data to import has to be in JSON format, as exported by
timew-export(1), i.e. a single array with interval objects.

When importing, the intervals are checked for overlaps with existing
intervals. If an overlap is found, the import will abort at the
first overlap and no more intervals are imported, unless the :adjust
hint is specified.

In general, it is recommended to create a backup of your data before
importing.

HINTS

:adjust
When given, the imported interval will overwrite any existing
intervals that it overlaps with.

EXAMPLES

Import intervals from a file

Import intervals from a single file:

timew import intervals.json

Any file path that does not start with a / is interpreted as
relative to the current working directory.

Import intervals from multiple files

One can also use shell wildcards and absolute paths:

timew import /path/to/intervals/*.json

Import intervals from standard input

Import intervals from stdin:

timew export | ssh <server> 'timew import'

This is especially useful for synchronizing intervals between
different machines.

timew 1.9.1 2025-08-16 TIMEW-IMPORT(1)