← Back to home
macOS · Apple SiliconWindows · x64Alpha

Install NoteSage in one line — or one click.

On a Mac, paste one line into Terminal: it fetches the current release, verifies the checksum, puts NoteSage in your Applications folder, and opens it. On Windows, download the 64-bit installer and run it. Updating later is the same step on both.

Install or update
curl https://notesage-mirror.naaico.com/install.sh | bash

SHA-512 verifiedInstalls to /ApplicationsKeeps your notes and keys

Auto updates

Coming soon

NoteSage will soon check the release feed itself and update in the background — no Terminal, no re-downloading anything. The mirror already publishes the update metadata for both platforms; the in-app updater ships once builds are signed and notarized. Until then, updating is whatever you did to install: run the one-liner again on a Mac, or run the newer installer on Windows, and the app is swapped in place.

Four steps, about two minutes

Most of that is the download — 168 MB on Windows, around 225 MB on macOS.

  1. Step 1

    Open Terminal

    Press ⌘ Space, type “Terminal”, and hit Return. Any shell works — zsh, bash, fish.

  2. Step 2

    Paste the command

    Copy the one-liner above, paste it into Terminal, and press Return.

  3. Step 3

    Let it verify and install

    The script downloads the current release, checks its SHA-512 against the published feed, and installs to /Applications. It refuses to install anything it cannot verify.

  4. Step 4

    Grant permissions on first run

    NoteSage launches automatically and asks for Microphone and Accessibility access. Both are needed to hear your meetings and to type dictation into other apps.

See exactly what it prints

Piping a script into bash deserves a look first. This is the installer's output, line for line — and the script itself is plain text you can read before you run it.

Terminal — what the installer does

$ Press Run it to preview every line the installer prints — nothing runs in your browser.

Questions

How do I update to a newer version?

On macOS, run the exact same command: the installer quits NoteSage if it is running, replaces the app bundle in /Applications, and leaves your notes, settings and stored API keys untouched. On Windows, download the newer installer and run it — it upgrades the existing installation in place and keeps your data. Either way, if the installed version is already current it simply reinstalls it.

Which Windows versions are supported?

Windows 10 and Windows 11 on 64-bit x64 hardware. There is no 32-bit build, and Windows on ARM is not supported yet — it would run under emulation, which we have not tested.

Windows says it “protected my PC”. Is that expected?

Yes, for now. Alpha builds are not yet signed with a certificate Windows recognises, so SmartScreen warns about an unknown publisher. Click More info, then Run anyway. If you would rather check first, the “Verify the download” link under the installer gives you a PowerShell one-liner and the expected SHA-512. Code signing arrives with the public release.

Does it work on an Intel Mac?

Not yet. On macOS, NoteSage currently ships for Apple Silicon (M1 and later) only, and the installer will say so rather than install anything under Rosetta. Intel builds are on the roadmap.

Why does the macOS installer clear the quarantine attribute?

Alpha builds are ad-hoc signed and not yet notarized, so Gatekeeper would refuse to open the app after a browser download. The script removes the quarantine flag on the freshly verified bundle — the SHA-512 check right before it is what guarantees you got the file we published. Developer ID signing and notarization arrive with the public release.

I had NoteSage installed. What happens to it?

NoteSage is the same product under its new name. On macOS the installer removes the old NoteSage.app and moves its data folder to the new name, so every note, setting and key carries over. If both folders already exist it keeps the NoteSage one and leaves the other in place.

What does the macOS script need on my Mac?

Only tools macOS ships with: curl, ditto, openssl and xattr. No Homebrew, no Xcode, no Node. If /Applications is not writable it will ask for your password once, for the copy step only.

How do I uninstall?

On macOS, drag NoteSage from /Applications to the Trash; to remove your data as well, delete the NoteSage folder inside ~/Library/Application Support, and remove any stored API keys from Keychain Access. On Windows, use Settings → Apps → Installed apps → NoteSage → Uninstall; your notes and settings stay in the NoteSage folder under %APPDATA% until you delete it.

Something else? Email us.

Verify the download

The macOS installer checks its own download. On Windows you can do the same by hand: run this in PowerShell and compare the result with the SHA-512 published in the update feed.

PowerShell — SHA-512 (base64)
[Convert]::ToBase64String([Security.Cryptography.SHA512]::Create().ComputeHash([IO.File]::ReadAllBytes("$HOME\Downloads\NoteSage-Setup-0.10.4-x64.exe")))
Expected — NoteSage-Setup-0.10.4-x64.exe

62QokiKUDuhGXg4xH0csGCB+nwndJfCmf5eoE51GrACE2bWEx3CEukP5cdAqRr4dzfjsBp+O2BP3ENrDV3xcoA==

Alpha builds are not code-signed yet, so SmartScreen will flag an unknown publisher on first run. Choose More info → Run anyway. The checksum above is what proves you have the file we published; code signing arrives with the public release.