Part 8 · Reference

Where your data lives

Treetor is local-first: a working copy of every tree stays on your own disk, while optional Sync & Backup stores only end-to-end encrypted copies. This page maps every local file and folder Treetor writes.

3 min read Verified on Treetor 0.1.25(current release 0.1.29)

The data folder: your trees

By default the data folder is Documents\Treetor. It contains:

  • Treetor.db — the database: every tree's title, note, collection and the list of its branches.
  • <tree id>\ — one folder per tree, named by an id rather than the title so renaming a tree never moves files.
  • <tree id>\*.bran — the tree's branches: the items and their structure.
  • <tree id>\media\ — the tree's pictures: the flattened picture you see, and next to it a .source.png copy with the editable annotations.
  • .treetor\workspace.json — the workspace marker: which account currently owns Sync for this folder.

Back up the whole data folder (or use Treetor Pack exports per tree). Changing the folder is done under Settings › Data & storage.

Settings: profiles and presets

Settings are per Windows user, under %APPDATA%\Treetor (usually C:\Users\<you>\AppData\Roaming\Treetor):

  • Settings\BranchEditor.Profile — your content profiles (fonts, colours, spacing).
  • Settings\jitann-config.json — annotation tool presets.
  • Settings\DataRoot.config — the one data folder this installation opens, independent of the signed-in account.
  • Users\<account key>\Settings\SyncMasterKey — that account's encrypted Sync key, when Sync is enrolled.
  • Auth\ — the sign-in session and licence token, encrypted for this Windows user. Deleting the folder signs you out.

Reinstalling Treetor keeps these; uninstalling does not remove them.

On-device diagnostic logs

If Treetor closes unexpectedly it writes a timestamped crash-*.txt report beside the rolling treetor.log under %APPDATA%\Treetor\Logs. Nothing is uploaded automatically. Reports exclude tree content by design and redact common credentials and direct identifiers. Review a file before attaching it to an email to support; you can delete diagnostic files afterwards.

macOS and Linux

  • Data folder: ~/Documents/Treetor/
  • Settings: ~/.config/Treetor/ (same sub-folders as above)
  • Diagnostic logs: ~/.config/Treetor/Logs/