{"id":22895365,"url":"https://github.com/adamkiss/alfred-noteplan","last_synced_at":"2025-05-07T20:02:33.713Z","repository":{"id":41815101,"uuid":"482343207","full_name":"adamkiss/alfred-noteplan","owner":"adamkiss","description":"Noteplan for Alfred: search through your notes with full-text","archived":false,"fork":false,"pushed_at":"2023-09-08T16:45:15.000Z","size":18705,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T13:35:33.644Z","etag":null,"topics":["alfred-workflow","alfred5-workflow","dart","full-text-search","noteplan","sqlite","sqlite3"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamkiss.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-16T19:27:25.000Z","updated_at":"2025-01-26T19:48:09.000Z","dependencies_parsed_at":"2023-02-16T22:50:35.321Z","dependency_job_id":null,"html_url":"https://github.com/adamkiss/alfred-noteplan","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamkiss%2Falfred-noteplan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamkiss%2Falfred-noteplan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamkiss%2Falfred-noteplan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamkiss%2Falfred-noteplan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamkiss","download_url":"https://codeload.github.com/adamkiss/alfred-noteplan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252949271,"owners_count":21830151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-workflow","alfred5-workflow","dart","full-text-search","noteplan","sqlite","sqlite3"],"created_at":"2024-12-13T23:29:01.102Z","updated_at":"2025-05-07T20:02:33.617Z","avatar_url":"https://github.com/adamkiss.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Noteplan for Alfred\n\n![OG Social image](social.png)\n\n## What is this\n\nNoteplan for Alfred brings all your Noteplan notes to Alfred 5 and beyond! Use it to:\n\n- 🔍 Search through all of your notes, with **full-text search**\n- ⚡ **Use Noteplan as link manager** - Search through all of your hyperlinks, and immediately open them in your default browser\n- 🌈 **Use Noteplan as snippet manager** - Search through your code bits (with title and description), and automatically paste them to your frontmost app\n- ✨ Create new notes easily\n- 📆 Go to an exact date, fuzzy date or even a weekly/monthly/quarterly note\n\nNote: this workflow **requires Alfred 5**. It uses configuration options introduced in the version 5.\n\n## Usage\n- `n [Search phrase]` - Full-text search through all notes, code bits and hyperlinks\n    - Also contains a \"create new note\" option\n    - if there's no match, the note creation is the only option\n- `nh [Phrase]` - Search through all the hyperlinks you noted down - and open them immediately\n- `nc [Phrase]` - Search for all your titled code bits - and paste them to the frontmost app\n- `nd [date phrase]` - Very simple exact/relative date parser\n- `nn [Title of the note]` - Creates a new note, in the folder of your choice\n- `n !r` - Refresh note database\n- `n !rf` - Force refresh every note in the database\n- `n !!` - Show debug information\n\nAll commands are configurable. To keep the workflow from being too complicated, if you don't wish to use a feature, just set the trigger to something complicated like `XYZ-extremely-unlikely-to-use`\n\n### Hyperlinks\n\nEvery hyperlink - `[The title and a description](https://example.com)` - is searchable, through the title and description and the link itself as well. **The default action for a hyperlink is to open it in a default browser**, to open the containing note, hit \u003ckbd\u003eCMD\u003c/kbd\u003e+\u003ckbd\u003e↩\u003c/kbd\u003e.\n\n### Code bits\n\nEvery block of code **with a title/description** is matched as a snippet. **Default action is \"copy and paste in the frontmost app\"**, to open the containing note, hit \u003ckbd\u003eCMD\u003c/kbd\u003e+\u003ckbd\u003e↩\u003c/kbd\u003e.\n\n#### Example code bit:\n\n````\n```language (Title and a description in parentheses)\n   This code bit will be matched as codebit by content, language and the title and description.\n```\n````\n\n### Date parser\n- `t … today` - today's note\n- `y … yesterday` - yesterday's note\n- `tom … tomorrow` - tomorrow's note\n- `[20]?220401` - exact date in Ymd format, where the initial 20 is optional\n- `0401` - exact day, current year (month first)\n- `4/1` - exact day, current year (month first, leading zero optional)\n- `1.4` - exact day, current year (day first, leading zero optional)\n- `1 4` - exact day, current year (leading zero optional, d/m order configurable)\n- `[-+]? [number] [dw]` - relative date, number of days or weeks back and forward. spaces are optional\n- `[wmq]` - this week's (month's, quarter's) note\n- `[wmq] [number]` -  weekly (monthly, quarterly) note of w/m/q X\n- `[wmq] -|+ [number]` - relative week's (month's, quarter's) note (spaces optional)\n- `yr|year` - this year's note\n- `yr|year [XY]` - note of the year 20XY\n- `yr|year -|+ [number]` - relative year (spaces optional)\n\n## Installation\n1. Download the workflow (`alfred-noteplan-X.Y.Z.alfredworkflow`) from the ['Releases' page](https://github.com/adamkiss/alfred-noteplan/releases) and import the workflow to Alfred\n2. Configure the workflow as you need and want\n    - the most important and required part is the **Noteplan root folder**\n    - get it through `Noteplan Options` \u003e `Sync` \u003e `'Advanced' for your active Sync option` \u003e `Open local database`\n    - this will open a Finder window\n    - in this window, with **nothing selected**, press \u003ckbd\u003eCommand\u003c/kbd\u003e+\u003ckbd\u003eOption\u003c/kbd\u003e+\u003ckbd\u003eC\u003c/kbd\u003e to copy the pathname \n    - paste that into the workflow import window\n3. Trust the app. This step is necessary because [the app is not signed](#why-all-the-warnings).      \n   1. Type `n ` in Alfred - macOS will warn you that this app is unsigned and you can move it to bin or cancel.\n   2. Open **System Settings** \u003e **Privacy \u0026 Security**, scroll down, and click \"Allow Anyway\". (In macOS before 13/Ventura, _System Settings_ is called _System Preferences_.)\n   3. Type `n ` in Alfred again - macOS will warn you _again_ that this app was downloaded from the internet and might not be safe.\n   4. The dialog now has an **Open** option. Click **Open** to finalize the authorization.\n4. Profit!\n5. You can now do a search, date query or add a new note\n\n### Why all the warnings?\nTo have macOS accept your app as safe, the developer needs to cryptographically sign it. That requires a $99/year Apple Developer Program, which I don't need for anything else, so the two warnings are acceptable for a free workflow in my opinion.\n\n### Wasn't there a refresh command?\nThere was. But with the new version, the workflow refreshes changed notes only, and that's often tiny number, so the database is updated every time this workflow is run (with debounce at ~10 seconds, so while you're querying your notes, it doesn't try to refresh every call).\n\n## License\n\nCopyright (c) 2023 Adam Kiss\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamkiss%2Falfred-noteplan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamkiss%2Falfred-noteplan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamkiss%2Falfred-noteplan/lists"}