Skip to content

Import and export

Import and export options are in Me menu → Preferences → Import/Export.

All imports and exports are scoped to the active workspace. Switch to the workspace you want before importing or exporting.

Import

Imports are idempotent — uploading the same file twice produces no duplicates. If an entry already exists in the workspace, it is silently skipped.

Stundu CLI export

Use this to bring in data from the stundu command-line app. The CLI stores everything in a single CSV file — there is no separate export step; you upload the file directly.

The default file is stundu_data.csv in whichever directory you run the CLI from. If you set a custom path via the STUNDU_DATA environment variable or the --data flag, use that file instead.

  1. Locate your stundu_data.csv (or custom data file).
  2. In Preferences → Import/Export, click Choose file under the Stundu CSV section and select it.
  3. Click Upload. Stundu reports how many entries and commands were imported and how many were skipped.

Timewarrior

Use this to import data from Timewarrior. Timewarrior stores its data in .data files, typically in ~/.timewarrior/data/.

  1. Locate your Timewarrior data files (one file per month, e.g. 2024-03.data).
  2. In Preferences → Import/Export, click Choose file under the Timewarrior section and select a .data file.
  3. Click Upload. Repeat for each file you want to import.

Export

Stundu CSV

Downloads all entries and billing rate commands for the active workspace as a Stundu-compatible CSV file. This is the recommended format for backups and for moving data back to the CLI — the export is a lossless round-trip.

Timewarrior

Downloads entries in Timewarrior's .data format. Use this if you want to move data from Stundu back to a Timewarrior-based workflow.

Ledger — timeclock

Downloads entries as a Ledger timeclock file. Each entry becomes a pair of i (clock-in) and o (clock-out) lines. Useful for time-based reports in Ledger.

Ledger — journal

Downloads billing transactions as a Ledger journal file using double-entry format. Each billable entry becomes a transaction with the billed amount. Useful for feeding time-tracking revenue into a Ledger-based bookkeeping setup.