TIMEW-IMPORT(1)

✨ TIMEW-IMPORT(1) ✨

okay bestie, welcome to timew-import from the User Manuals — this is the page that teaches you how to yeet your time-tracking data into timew from a file 💖

---

🌸 NAME 🌸

timew-import — import time-tracking data from files 🦋

---

⭐ SYNOPSIS ⭐

timew import [<file>...]

---

💜 DESCRIPTION 💜

So here's the vibe: you're importing tracked time from a file. That's it, that's the whole thing. But if you don't specify any files at all? No worries bestie, the command will just read from standard input instead 🫶

Now, the data you're importing has to be in JSON format, exactly the way it gets exported by timew-export(1) — meaning it's a single array full of interval objects. No cap, that's the only format it'll accept 🙈

When you import, all those intervals get checked for overlaps against the intervals you already have. And if an overlap shows up? the import will abort at the first overlap and no more intervals are imported — unless you've specified the :adjust hint. So like, it literally stops dead the second things get messy 😭

In general, it is recommended to create a backup of your data before importing. 🚨 Fr fr, back up your stuff first. Don't be the person who raw-dogs an import and loses their whole timeline. That's not main character energy, that's just tragedy.

---

🎀 HINTS 🎀

• :adjust — When given, the imported interval will overwrite any existing intervals that it overlaps with. 💅 Yes queen, it just bulldozes right over them.

---

🔥 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. So no slash = it's looking right where you're standing, iykyk 👑

🌈 Import intervals from multiple files

One can also use shell wildcards and absolute paths:

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

Shell wildcards? Absolute paths? Both at once? Obsessed. Ate. ✨

🌈 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. 🦋 Piping your whole timeline across the network into another box? Iconic behaviour, honestly. 👑

---

💖 SEE ALSO 💖

timew-export(1) — that's your source of the JSON format, go read it too 🎀

---

timew 1.9.1 · 2025-08-27

and that's the whole page bestie, mwah 💅💖 stay tracked, stay un-overlapped, periodt ✨🌸