TIMEW-EXPORT(1)

📦
version 1.9.1 · 9 versions
, in ubuntu resolute, ubuntu stonking

💅 TIMEW-EXPORT(1) — the timew-export girlies' guide

okay bestie, welcome to timew-export, straight out of the timew User Manuals ✨ this is the one that dumps all your tracked time out as JSON and honestly? it's giving data-liberation, it ate 💖

🌸 NAME 🌸

timew-export — export tracked time in JSON 🎀

✨ SYNOPSIS ✨

timew export [ <id>... | ([<range>] [<tag>...]) ]

so you either hand it a bunch of ids, orrrr you give it a range and/or *tag*s — pick a lane, it's either/or, no cap 🫶

💜 DESCRIPTION 💜

Bestie. It exports all the tracked time in JSON format. That's the whole vibe 💅

Now, if you don't want everything (main character energy but make it selective), you can supply either:

  • a list of interval IDs 👑
  • or a range and/or tag filter (go peep timew-ranges(7) and timew-tags(1) for the deets on those) — this way you only export a subset of intervals 🦋

The data comes out as a JSON array of interval objects, and each one contains the interval's start time, end time, current id, tags, and annotation if present. Like, only if it's there, yk? 🙈

🔥 EXAMPLES 🔥

⭐ Export all intervals

Calling the export command with no arguments at all exports all tracked intervals in JSON format, periodt:

$ timew export
[
{"id":2,"start":"20231001T103000Z","end":"20231001T120000Z","tags":["work"],"annotation":"Project work"},
{"id":1,"start":"20231001T090000Z","end":"20231001T100000Z","tags":["work"],"annotation":"Morning meeting"},
]

In this example there are literally only two intervals present in the database. And the output is sorted by start time, with the oldest interval first — so the oldest one is the main character, walking in first 🌈

⭐ Export intervals filtered by range and tag

$ timew export from 2016-01-01 for 3wks tag1
...

⭐ Export intervals by their ids

$ timew export @1 @3 @7
...
ngl the ... in those last two examples is exactly what the manpage shows — no extra output given, so don't come for me, I'm just the messenger 😭

🎀 sign-off 🎀

that's the whole page, bestie! brought to you by timew version 1.9.1, dated 2025-11-02 — go forth and export your little heart out, you're doing amazing sweetie 💖✨🦋

📦 where this page comes from