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.
curl https://notesage-mirror.naaico.com/install.sh | bashSHA-512 verifiedInstalls to /ApplicationsKeeps your notes and keys
NoteSage-Setup-0.10.4-x64.exe
168 MB · Windows 10 & 11 · 64-bit (x64)
SHA-512 publishedInstalls for your userKeeps your notes and keys
Rather check it first? .
Auto updates
Coming soonNoteSage 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.
- Step 1
Open Terminal
Press ⌘ Space, type “Terminal”, and hit Return. Any shell works — zsh, bash, fish.
- Step 2
Paste the command
Copy the one-liner above, paste it into Terminal, and press Return.
- 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.
- 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.
- Step 1
Download the installer
Grab NoteSage-Setup-0.10.4-x64.exe — about 168 MB. It is a 64-bit build for Windows 10 and 11; Windows on ARM is not supported yet.
- Step 2
Check it, if you like
Alpha builds are not code-signed yet, so Windows may show a “Windows protected your PC” screen. Choose More info → Run anyway — or use the “Verify the download” link to check the SHA-512 first.
- Step 3
Run it
The installer sets NoteSage up for your user account, adds a Start menu shortcut, and opens the app when it finishes. Nothing else is required.
- Step 4
Allow the microphone
NoteSage asks for microphone access the first time you record. If Windows blocks it, switch it on under Settings → Privacy & security → Microphone.
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.
$ 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.
