apple-notes-exporter-rs-1.0.0 is not a library.

Visit the last successful build: apple-notes-exporter-rs-3.0.0

Apple Notes Exporter

A command-line tool for recursively exporting Apple Notes folders to the file system via AppleScript. This Rust-based tool allows you to export entire folder hierarchies from Apple Notes, creating a mirrored directory structure with each note saved as an HTML file.

Quick Install

Install from crates.io using Cargo:

cargo install apple-notes-exporter-rs

Or install directly from GitHub:

cargo install --git https://github.com/pRizz/apple-notes-exporter-rs.git

Features

✅ Recursive export of Apple Notes folders (including all subfolders and notes)
✅ Creates a mirrored directory tree structure
✅ Exports each note as an HTML file
✅ Breadth-first search (BFS) to find folders at any level
✅ Support for multiple Apple Notes accounts
✅ Simple command-line interface

Installation

Install from crates.io (Recommended)

cargo install apple-notes-exporter-rs

Install from GitHub

Install directly from the GitHub repository:

cargo install --git https://github.com/pRizz/apple-notes-exporter-rs.git

Build from Source

git clone https://github.com/pRizz/apple-notes-exporter-rs.git
cd apple-notes-exporter-rs
cargo build --release

The binary will be available at target/release/apple-notes-exporter.

Usage

The tool requires an output directory and a folder name to export. Only one folder can be exported at a time.

Basic Usage

apple-notes-exporter -o <OUTPUT_DIR> <NOTES_FOLDER>

Options

-o, --output-dir <DIR> - Output directory for exported notes (required)
<NOTES_FOLDER> - Apple Notes folder name to export recursively (required, positional argument)

Examples

Export a folder from the default iCloud account:

apple-notes-exporter -o ./exports "My Notes"

Export a folder from a specific account (useful when folder names exist in multiple accounts):

apple-notes-exporter -o ./exports "iCloud:My Notes"
apple-notes-exporter -o ./exports "Google:Work Notes"

How It Works

Folder Search: The tool uses breadth-first search (BFS) to find the specified folder at any level in your Apple Notes hierarchy (not just top-level folders).
Export Process: Once found, it recursively exports that folder and all its subfolders, creating a mirrored directory tree.
Output Format: Each note is exported as an HTML file, preserving the folder structure in the output directory.
Account Handling: By default, the folder search looks in the "iCloud" account. If a folder name exists in multiple accounts, you can specify the account using the AccountName:FolderName format.

Requirements

macOS Only

This tool is macOS-specific as it relies on AppleScript to interact with the Notes app.

Automation Permissions

Important: This tool requires Automation permissions for the Notes app. You'll need to grant these permissions when you first run the tool:

Go to System Settings > Privacy & Security > Automation
Find the application that invoked the script (e.g., Terminal, iTerm, or Script Editor)
Enable permissions for the Notes app

If permissions are not granted, the export will fail.

Project Structure

apple-notes-exporter-rs/
├── src/
│   └── main.rs              # Main application code
├── vendor/
│   └── apple-notes-exporter/
│       └── scripts/
│           └── export_notes_recursive.applescript  # AppleScript used for export
├── Cargo.toml
└── README.md

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

This tool uses the AppleScript from the apple-notes-exporter project, which is included as a vendor dependency.

apple-notes-exporter-rs 1.0.0