Skip to content

v2.1

Latest

Choose a tag to compare

@kzaremski kzaremski released this 15 Sep 02:46
· 1 commit to main since this release

v2.1 - Pick how your export is delivered, and trust what comes out

Every export now goes where you want it in the shape you want it: a folder tree, a .zip, a .tar, or one joined file. Alongside that, this release is heavily about correctness; the CLI, MCP server and Shortcuts actions each carried their own copy of the export logic, and this release makes them one engine, fixing a long list of things that were silently wrong in some surfaces but not others.

Output destinations

  • Folder, ZIP Archive, TAR Archive, or Single File. Step 3 now picks how the export is delivered. Each lets you name the file, and creation and modification dates are preserved inside archives.
  • The CLI takes --zip, --tar and --concatenate, with an --output that may name the archive or the file directly.
  • Single File works for 14 formats, not 2. The GUI previously offered it for Markdown and plain text only, though it could always produce the rest. Packaged formats (PDF, DOCX, ODT, EPUB) are excluded, and the CLI now refuses them instead of writing a DOCX into a text file.

CLI

  • Real folder selection. --folder takes an exact name or a folder id, can be repeated or comma-separated, and includes subfolders by default. --folder-contains restores substring matching; --no-subfolders limits a selection to direct children.
  • Mistyped folder filters fail loudly. A --folder matching nothing used to fall through to "no filter" and export your entire library. It now errors and lists the folders that do exist.
  • Recently Deleted via --include-deleted or --folder "Recently Deleted".
  • Sync history. Each incremental run appends a file-level diff (added, updated, deleted) to the manifest, and notes-export sync-status prints the recent history.
  • Shared attachment dumps with --shared-attachments, writing every file under Attachments/ instead of a folder beside each note.
  • Optional HTML folder indexes (--html-indexes) so an HTML export is browsable in a web browser.

Shortcuts and MCP

  • Shortcuts exposes the whole exporter. The Export action carried its own cut-down copy of the export logic and offered 7 parameters; it now runs the same engine as the CLI with 23, plus new List Notes and Sync Status actions.
  • MCP setup in the app. Help > Connect to an AI Assistant shows the server path and a copyable Claude Desktop config. The server gains get_note for reading one note's real content in any text format, and export_notes now matches the CLI option for option.

Fixes

  • Internal note links resolve. applenotes:note/UUID links were looked up by the wrong key and never rewrote in HTML or Markdown exports. (#37, thanks @s-t-u)
  • Unfiled notes land in the account's default folder instead of a synthetic "Unknown Folder", matched by Apple's own marker so localized libraries work. Incremental runs also heal manifests that parked notes there previously. (#36, thanks @anthonyjclarke)
  • Full Disk Access registration uses an absolute path, and the app explains how to add itself to the list if it does not appear. (#38, thanks @Calorion)
  • Incremental sync no longer deletes filtered-out notes. Pruning is judged against the whole library rather than the current run's selection, so exporting one folder into an existing sync directory does not remove the others. It is also skipped entirely when the library cannot be read, rather than treating that as "everything was deleted".
  • Deleted notes are pruned from the output directory on incremental runs instead of being left behind.
  • Gallery attachments export from the CLI, MCP server and Shortcuts. Only the app knew how to expand a gallery into its images; everywhere else they were silently dropped.
  • ENEX imports into Evernote. Images were left inline as base64, putting one note 22x over Evernote's 5 MB limit. They are now <resource> elements referenced by <en-media>, and the output validates against Evernote's own enml2.dtd and evernote-export3.dtd. Oversized notes are called out in the export log.
  • Single File output is a single file. It no longer builds an empty account and folder tree beside the one file it was asked for, and HTML folder indexes are no longer written through the folder you saved into.
  • Concatenated XML, OPML and ENEX are valid documents with one root, instead of one declaration and root per note.
  • Plain text is actually plain... it was emitting raw HTML in some cases, base64 image payloads included.
  • CLI output matches the app's. Markdown links its images instead of embedding megabytes of base64; JSON, JSONL, XML and CSV write folder names instead of raw ids; RTF uses your configured font and LaTeX your configured template.
  • Database access is serialized, fixing intermittent "no accounts found" failures in the GUI.
  • EPUBs open in Apple Books (correct EPUB 3 OCF layout), plus DOCX and ODT fixes.
  • A working Help menu. It previously raised "Help isn't available for Apple Notes Exporter"; it now links to the documentation, Full Disk Access setup, and the issue tracker.
  • Exports are reproducible. Export order came from an unsorted dictionary, so it varied between runs, which also decided which of two same-titled notes got the (2) suffix.
  • Signing moved into xcconfigs with release verification as a build gate, which should resolve the code signing verification failure reported in #39

Under the hood

The app, CLI, MCP server and Shortcuts actions now share one export engine rather than four copies of it. A new parity test suite runs the app's engine and the CLI's engine against a generated fixture library and diffs every file they produce, and an 18-format x 4-destination matrix validates the output by parsing it. Both run in CI on every push, along with the unit tests, which CI previously built but never ran.

Contributors

Thanks to @davideg (David Ginsburg) for fixing Markdown exports to decode HTML entities (#40), and to @vrisher (Vaughan Risher) for preserving image attachments in Markdown exports (#41).

Continued thanks to @AnotherCoolDude (Christian Hovenbitzer) for the CLI and MCP server, @Schneppi (Sascha Schneppmüller) for the app icon, and @nikolsky2 (Sergey Nikolsky) for past contributions; this release builds directly on their work.

And thank you to everyone who filed an issue this cycle: @s-t-u, @anthonyjclarke, @Calorion, @xuorelj and @ferlatte. Several of the fixes above exist because you took the time to write up exactly what went wrong.

Please reach out to me by email or GitHub issues with any bugs, questions, or comments. Thank you all very much for your interest and support of this project!

Full Diff: v2.0-2...v2.1