Skip to content

URL Schemes

FoldNotes registers the foldnotes:// URL scheme for deep-linking into the app.

Open a Note

foldnotes://open?id=<noteUUID>&collection=<collectionUUID>
foldnotes://open?title=Meeting+Notes&collection=<collectionUUID>
Parameter Description
id Note UUID (from front matter)
title Note title (URL-encoded)
collection Collection UUID (optional — defaults to active collection)

Open a Task

foldnotes://task?id=<taskUUID>&note=<noteUUID>&collection=<collectionUUID>

Opens the note and scrolls to the specific task.

Parameter Description
id Task UUID (paragraph UUID)
note Note UUID containing the task
collection Collection UUID (optional)

Open Today's Daily Note

foldnotes://daily

Opens today's daily note, creating it if it doesn't exist.

Open the App

foldnotes://

Brings FoldNotes to the foreground.

Collection Switching

When a URL includes a collection parameter pointing to a different collection:

Scenario Result
Same collection (or no collection param) Opens the note directly
Different collection, app not running Switches to that collection and opens the note
Different collection, app is running Shows a confirmation alert before switching

URLs without a collection parameter (e.g. from older versions) are backward compatible — they open in the current active collection.

  • Copy Note Link (Edit menu, Cmd+Shift+C) — foldnotes://open?id=...&collection=...
  • Copy Task Link (Edit menu) — foldnotes://task?id=...&note=...&collection=...
  • Copy Link (backlink context menu) — includes collection
  • Copy Link (Notes List context menu) — includes collection
  • CLI (fn open, fn daily --open, fn create --open) — includes collection

Using URL Schemes

From the Terminal

open "foldnotes://open?title=Meeting+Notes"
open "foldnotes://daily"

From Apple Shortcuts

Use a Run Shell Script action:

/usr/bin/open "foldnotes://open?title=Meeting+Notes"

From the CLI

The fn open command uses URL schemes internally:

fn open "Meeting Notes"    # Opens via foldnotes://open?id=...
fn open --daily            # Opens via foldnotes://daily