{"id":13475529,"url":"https://github.com/sballin/alfred-search-notes-app","last_synced_at":"2026-01-14T22:43:02.053Z","repository":{"id":37396912,"uuid":"142307853","full_name":"sballin/alfred-search-notes-app","owner":"sballin","description":"Use Alfred to quickly open notes in iCloud/Apple Notes. Written in Go and designed for speed.","archived":false,"fork":false,"pushed_at":"2025-01-15T10:55:42.000Z","size":424,"stargazers_count":558,"open_issues_count":8,"forks_count":23,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-03-27T00:34:37.372Z","etag":null,"topics":["alfred","apple-notes","icloud-notes","notational-velocity","notes-app"],"latest_commit_sha":null,"homepage":"https://www.alfredforum.com/topic/11716-search-appleicloud-notes/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sballin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"sballin","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2018-07-25T14:00:05.000Z","updated_at":"2025-03-25T10:32:24.000Z","dependencies_parsed_at":"2023-12-26T22:20:18.813Z","dependency_job_id":"edab1a6f-1895-4fba-81b0-413f35a89dc0","html_url":"https://github.com/sballin/alfred-search-notes-app","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/sballin/alfred-search-notes-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sballin%2Falfred-search-notes-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sballin%2Falfred-search-notes-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sballin%2Falfred-search-notes-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sballin%2Falfred-search-notes-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sballin","download_url":"https://codeload.github.com/sballin/alfred-search-notes-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sballin%2Falfred-search-notes-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28436728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T22:37:52.437Z","status":"ssl_error","status_checked_at":"2026-01-14T22:37:31.496Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alfred","apple-notes","icloud-notes","notational-velocity","notes-app"],"created_at":"2024-07-31T16:01:21.215Z","updated_at":"2026-01-14T22:43:02.035Z","avatar_url":"https://github.com/sballin.png","language":"Go","funding_links":["https://patreon.com/sballin","https://www.patreon.com/sballin","http://paypal.me/sbballin)!"],"categories":["Go","Utility"],"sub_categories":[],"readme":"# Search Notes.app with Alfred\n\nThis is an Alfred workflow to find and open Apple/iCloud notes in Notes.app! It's written in Go and designed to be ripping fast, even for very large Notes databases, can search everything including note and attachment contents, and supports accented characters and non-Latin scripts. \n\n* Download the latest version: [[github]](https://github.com/sballin/alfred-search-notes-app/releases/latest/download/Search.Notes.alfredworkflow)\n* Instructions to fix permissions issues: [[github]](https://github.com/sballin/alfred-search-notes-app?tab=readme-ov-file#troubleshooting)\n* View additional issues and get help: [[github]](https://github.com/sballin/alfred-search-notes-app/issues?q=is%3Aissue)\n* Support me maintaining this thing and keeping the binary verified: [[patreon]](https://www.patreon.com/sballin)\n\nPrivacy note: this workflow uses a Go binary to search your Notes database. The binary is [open source](https://github.com/sballin/alfred-search-notes-app/blob/master/search_notes/main.go) with [instructions](https://github.com/sballin/alfred-search-notes-app/tree/master?tab=readme-ov-file#compile) on how to compile it yourself. For extra peace of mind, consider supporting me on [Patreon](https://www.patreon.com/sballin) so that the binary can be regularly verified for malicious content by Apple ($99/year Apple Developer Program membership required). \n\n### Search titles or create a new note if none was found\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2719004/83949726-62850e00-a7f3-11ea-99a7-48f8c67cd480.png\" width=\"654\"\u003e\n  \n\u003cimg src=\"https://user-images.githubusercontent.com/2719004/83949516-403ec080-a7f2-11ea-940c-1813559ce462.png\" width=\"654\"\u003e\n\n### Search note titles and bodies\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2719004/83949619-e094e500-a7f2-11ea-8802-7856620d4ec8.png\" width=\"654\"\u003e\n\n### Search folder names\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2719004/83949622-e25ea880-a7f2-11ea-92fa-b2250e574402.png\" width=\"654\"\u003e\n\n### Result actions\n\n*   **enter** to open the note/folder or create a new note if none was found\n*   **shift+enter** to search for your Alfred query using the Notes in-app search \n*   **cmd+enter** to copy the note body to the clipboard\n*   **alt+enter** to copy a link to the note to the clipboard\n\n### Note linking\n\nYou can generate links to any of your notes and use them on macOS or iOS. Copy the note URL by pressing alt+enter on an Alfred result or paste it using the snippet. This will generate two links. The first one works on macOS Big Sur (11) and newer, and the second one works on iOS.\n\n## Install\n\nDownload the [latest version](https://github.com/sballin/alfred-search-notes-app/releases/latest/download/Search.Notes.alfredworkflow) of the workflow if you're on the latest macOS with Alfred \u003e= 4. For older versions of macOS, you may need to use [older versions](https://github.com/sballin/alfred-search-notes-app/releases) of the workflow.\n\n### Required setup\n\n1. Try searching for a note\n2. If a warning dialog appears (see image below), click \"Cancel\" rather than \"Move to Trash\". Then open System Preferences \u003e Security \u0026 Privacy and click the \"Open Anyway\" button near the bottom\n4. Approve additional requests for permission as they appear\n5. If there are any other issues, please follow the advice under [troubleshooting](#troubleshooting), if present, is enabled\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2719004/123869471-0b227600-d8ff-11eb-8c20-6537055b1336.png\" width=\"890\"\u003e\n\n### Troubleshooting\n\nIf the script produces an error, especially after installing updates to macOS, try turning the permissions below off and on again. Please look through [common issues](https://github.com/sballin/alfred-search-notes-app/issues?q=) before submitting a new one.\n\n__The most common issue `panic: unable to open database file: operation not permitted` is fixed by turning full disk access for Alfred off and on again.__\n\n\u003cimg src=\"https://github.com/sballin/alfred-search-notes-app/assets/2719004/566002dd-f3be-4b98-88b7-16d6e185d531\" width=\"890\"\u003e\n\n### Email notes are not supported\n\nThis workflow doesn't support notes stored with Google or other internet accounts. Please make sure either iCloud or On My Mac is selected as the default account in the preferences of Notes.app.\n\n## Customize search behavior\n\nResult ordering and title+folder search behavior can be controlled using the [environment variables](https://www.alfredapp.com/help/workflows/advanced/variables/#environment).\n\n## Updates\n\nBy default, the workflow checks Github for updates if you run it and it's been 4 days since the last check. This can be disabled by removing the connections to the OneUpdater block in the workflow.\n\n## Compile\n\nIf you want to compile the binary yourself, you can go into the \"search_notes\" folder and do `make`.\n\n## Contributors\n\nBig thanks to...\n\n* All who have submitted pull requests\n* drgrib for allowing me to build off the [alfred-bear](https://github.com/drgrib/alfred-bear) workflow\n* threeplanetssoftware for the [apple_cloud_notes_parser](https://github.com/threeplanetssoftware/apple_cloud_notes_parser) from which I copied the protobuf handling\n* [lslz627](https://github.com/lslz627) for help with protobuf and tables\n* [Artem Chistyakov](https://temochka.com/blog/posts/2020/02/22/linking-to-apple-notes.html) for a much improved way to create links to notes\n* [vitorgalvao](https://github.com/vitorgalvao) for the OneUpdater code\n\n## Donate\n\nIf you enjoy using this workflow, consider [donating](http://paypal.me/sbballin)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsballin%2Falfred-search-notes-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsballin%2Falfred-search-notes-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsballin%2Falfred-search-notes-app/lists"}