'\" t
.\"     Title: timew-import
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-16
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-IMPORT" "1" "2025-08-16" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
timew-import \- import time\-tracking data from files
.SH "SYNOPSIS"
.sp
.nf
\fBtimew import\fP [\fI<file>\fP\fB...\fP]
.fi
.br
.SH "DESCRIPTION"
.sp
Import tracked time from \f(CRfile\fP.
If no files are specified, the command will read from standard input.
.sp
The data to import has to be in JSON format, as exported by \fBtimew\-export\fP(1), i.e. a single array with interval objects.
.sp
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 \f(CR:adjust\fP hint is specified.
.sp
In general, it is recommended to create a backup of your data before importing.
.SH "HINTS"
.sp
\fB:adjust\fP
.RS 4
When given, the imported interval will overwrite any existing intervals that it overlaps with.
.RE
.SH "EXAMPLES"
.sp
\fBImport intervals from a file\fP
.RS 4
.sp
Import intervals from a single file:
.sp
.if n .RS 4
.nf
.fam C
timew import intervals.json
.fam
.fi
.if n .RE
.sp
Any file path that does not start with a \f(CR/\fP is interpreted as relative to the current working directory.
.RE
.sp
\fBImport intervals from multiple files\fP
.RS 4
.sp
One can also use shell wildcards and absolute paths:
.sp
.if n .RS 4
.nf
.fam C
timew import /path/to/intervals/*.json
.fam
.fi
.if n .RE
.RE
.sp
\fBImport intervals from standard input\fP
.RS 4
.sp
Import intervals from stdin:
.sp
.if n .RS 4
.nf
.fam C
timew export | ssh <server> \*(Aqtimew import\*(Aq
.fam
.fi
.if n .RE
.sp
This is especially useful for synchronizing intervals between different machines.
.RE