Help
Common problems, with the fix for each.
Problems and questions
For anything on the command line, run exporter doctor first: it prints a fix under each failing check.
Still have questions? Get in touch
Exporter says "that is not the Apple Notes folder"
You selected a folder other than the one the panel opened in. Press "try again", then "Select this folder" without opening anything. Other apps say it in their own words, like "no chat.db in that folder"; the fix is the same, and for Logseq select the graph folder that holds
db.sqlite or pages/.A connected app reads "not connected" again
The folder Exporter remembered was moved, deleted, or is on a drive that is not mounted. Connect the app again, or mount the drive.
Nothing was exported
The card needs a folder in
export to, one press of "sync now" (real-time sync starts after it) and something ticked on the tab it is on. On Messages, "sync now" waits for the first pass over your history. The Export log (the clock icon) shows the error that stopped a failed run.The export stopped at 100 notes, or 10 conversations
That is the free allowance: what was exported keeps syncing, and new items are left out while the card says "free limit reached". The app does not say how many it left out;
exporter sync prints the count. Unlock the app on its card (pricing).I unlocked, but the export is still limited
Press "sync now" on the card: the next sync writes everything, every Messages conversation included. On another Mac, press "restore purchase" first.
Edits do not show up in the files
Exporter has to be running: closing the window is fine, quitting stops syncing (
exporter sync catches up). Real-time sync starts after the first "sync now" on that card. The item may also be unticked or past the free allowance. Each app's page under Apps lists its own problems and fixes.An image or attachment is missing
Its file is not on this Mac yet, for example one Apple Notes or Messages has not downloaded; the Export log lists it as "source file not found". Open the note or conversation so it downloads, then sync again.
Files of deleted notes are still in the export
Every app removes them on the next sync, Bear's retagged notes and Logseq's renamed pages included; press "sync now" if Exporter was not running. Screen Time keeps every day on purpose, and an item you untick keeps its last file.
Markdown and HTML files are mixed in one folder
A sync removes only old files of the format it writes, so switching formats leaves the other ones behind. Give each format its own export folder.
What does "full resync" remove?
Only the files Exporter wrote in the export folder. Then it exports again and picks the free items again. Anything else in the folder stays: your own notes, a vault's
.obsidian, a folder of documents.Claude cannot see my exports
The MCP server runs inside the app, reads Markdown only, and serves only the export folders next to the Apple Notes one. Keep the folders side by side, then press "stop" and "start" on the MCP Server card. The MCP server has the rest.
exporter: command not found
Press "copy install command" on the Command Line card, paste it in Terminal and open a new window: the sandboxed app cannot write to your PATH itself. In cron, use the full path
exporter help cron prints. When the card says "needs reinstall", or a backup tool sees exit code 19, paste the install command again.exporter sync says Exporter is running
Nothing to fix: the app already keeps the folders current, so
sync does nothing. For a separate copy while the app runs, use exporter export --dest.exporter export says a folder is not authorized
--dest must be inside a folder granted on the Command Line card: press "add folder…" under "export destinations". exporter list dests shows what is granted.Can Exporter change my data, or upload it?
No. It only reads your apps, the Apple Notes database read-only, and writes only into the export folders you choose, where it removes only files it wrote itself. There is no account and no upload (privacy).
Which Macs does it run on?
Macs with macOS 15 or later. Since version 3.23 it is built for Apple silicon only; 3.22 was the last version for Intel Macs. There is no iPhone or iPad version.
How do I reach support?
In the app, Help & Support (the question mark) sends a problem, an idea or a question, and exporter@tinysend.com reaches Anton directly. From Terminal,
exporter report --send --email you@example.com sends a diagnostic report with no note contents.