Apple Notes Exporter

A library and CLI 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)
List all available folders across all accounts
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 with subcommands
Library API for programmatic access

CLI 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 --recursive 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.

CLI Usage

The tool provides two subcommands: list (or ls) and export.

List Available Folders

List all top-level folders across all Apple Notes accounts:

apple-notes-exporter list
# or
apple-notes-exporter ls

Export a Folder

Export a folder recursively to HTML files:

apple-notes-exporter export <FOLDER> <OUTPUT_DIR>

Examples

List all available folders:

apple-notes-exporter list   # or: apple-notes-exporter ls

Export a folder (searches all accounts):

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

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

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

Running from Source

If you want to run the tool directly from the source code without installing:

# Clone the repository with submodules
git clone --recursive https://github.com/pRizz/apple-notes-exporter-rs.git
cd apple-notes-exporter-rs

# List folders
cargo run -- list   # or: cargo run -- ls

# Export a folder
cargo run -- export "My Notes" ./exports

If you already cloned without --recursive, initialize the submodules:

git submodule update --init --recursive

Library Usage

Add the dependency to your Cargo.toml:

[dependencies]
apple-notes-exporter-rs = "1.0"

Quick Start

use apple_notes_exporter_rs::{list_folders, export_folder, export_folder_from_account};

fn main() -> apple_notes_exporter_rs::Result<()> {
    // List all available folders (prints to stdout)
    list_folders()?;

    // Export a folder to a directory (searches all accounts)
    export_folder("My Notes", "./exports")?;

    // Export from a specific account (useful when folder names are duplicated)
    export_folder_from_account("iCloud", "Work", "./exports")?;
    export_folder_from_account("Google", "Work", "./google_exports")?;

    Ok(())
}

Using the Exporter Struct

For more control, use the Exporter struct:

use apple_notes_exporter_rs::Exporter;

fn main() -> apple_notes_exporter_rs::Result<()> {
    // Create an exporter with the embedded AppleScript
    let exporter = Exporter::new();

    exporter.list_folders()?;
    exporter.export_folder("My Notes", "./exports")?;
    exporter.export_folder_from_account("iCloud", "Work", "./work_exports")?;

    Ok(())
}

Using a Custom AppleScript

If you need to use a modified AppleScript:

use apple_notes_exporter_rs::Exporter;

fn main() -> apple_notes_exporter_rs::Result<()> {
    let exporter = Exporter::with_script_path("./custom_script.applescript")?;

    exporter.list_folders()?;
    exporter.export_folder("My Notes", "./exports")?;

    Ok(())
}

Error Handling

The library provides a custom ExportError type:

use apple_notes_exporter_rs::{export_folder, ExportError};

fn main() {
    match export_folder("My Notes", "./exports") {
        Ok(()) => println!("Export successful!"),
        Err(ExportError::ScriptNotFound(path)) => {
            eprintln!("Script not found: {}", path.display());
        }
        Err(ExportError::ScriptFailed(code)) => {
            eprintln!("AppleScript failed with exit code: {}", code);
        }
        Err(e) => eprintln!("Error: {}", e),
    }
}

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 all accounts. 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. While the library can be compiled on any platform, running it on non-macOS systems will return an error at runtime.

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/
│   ├── lib.rs               # Library with public API
│   └── main.rs              # CLI application
├── vendor/
│   └── apple-notes-exporter/
│       └── scripts/
│           └── export_notes.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 git submodule.

apple-notes-exporter-rs 2.0.4