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.
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/