Skip to content

Latest commit

 

History

History
150 lines (81 loc) · 6.64 KB

README.md

File metadata and controls

150 lines (81 loc) · 6.64 KB

Donate

Bear Workflow

Streamlined note searching and creation for Bear using Alfred.

Install

  1. Download the latest release and double-click Bear.alfredworkflow. Alfred will open the workflow and install it.
  2. Authorize all the executables used by the workflow.
  3. If you are on an Apple Silicon Mac (M1, M2, etc.), install Rosetta

If you are using an old version of Bear before 2.0 use this download link for the latest version supporting it.

Search

bs or bsearch

Recent Notes

Leave the search field empty to see recent notes with their tags as subtitles.

Basic Search

Start typing to search through the titles and text of most recent notes, title matches first.

Tag Search

Type # at any time to autocomplete your tags.

Start typing to search tags.

Once completed, the notes will be filtered by that tag.

Add more tags to filter by multiple tags.

Start typing to search titles and text within a tag.

All these terms can be typed in any order and they will work the same. For example, if you want to add a tag after typing a bare search term, the autocomplete will still help you. Or if you remember you want to filter by another tag after typing the first tag and a bare search term, you can autocomplete and add the second tag by typing # again.

Search in Bear App

You can search any query you type in the Bear app's main window by holding down the option key. If you've entered a tag, it will open the Bear main window to that tag for further browsing.

The workflow will also autocomplete any of Bear's Special Search keywords if you start typing @ or -@.

If you use these keywords and have no other search results, the workflow will automatically populate a "Search ... in Bear App" item without you needing to press option.

Open Note in Bear App

Similarly, you can open any note you select in the Bear app's main window by holding down the command key.

Link Pasting

While in your Bear notes, you can paste a link to another note by searching for it and holding down the shift key.

Table of Contents Pasting

Similarly, you can paste a table of contents for a note by searching for it and holding down the command and shift keys.

New Notes

bn or bnew followed by title and optional tags.

Tag autocomplete works the same. Also, any text in your clipboard can be added to the new note by holding down the command key.

Create/Search

bcs or bcsearch

You may find sometimes that you want to retrieve a note if it exists and create it if it does not. This command provides that functionality by combining the behavior of search and create. It will provide all the same search results as normal search and additionally add a create item third in the list using normal create options.

If there are less than two search items, the create item will be the last or only item.

You can additionally create links to notes by holding the shift key while selecting a search item. Selecting the create item while holding the shift key will do nothing.

Why I created this

I am especially grateful to Chris Brown, who created a Python based Bear workflow. It was the basis for this project. However, I decided to create my own project for a few reasons:

  • Compiled Go is faster than interpretted Python. Not that much faster but fast enough for me to notice when searching and creating notes throughout the day.
  • I wanted the features involving tag searching and autocompletion, link pasting, and automatic clipboard note content.
  • I wanted fewer, more optimized SQL queries into the Bear database to increase speed since this appears to be the main bottleneck on performance.

Authorization

The first time you use the workflow after installing or upgrading, you will see a security warning:

This is a quirk of macOS 10.15 and above. Apple currently forces developers to pay $99 a year to be able to officially sign their executables and avoid this warning, which I'm not going to pay since I'm providing this workflow for free as an open source project.

After seeing this warning, you have to go to System Preferences > Security & Privacy > General and click the new button that has appeared to allow the executable to run. You then have to run it again and you will see this security warning again but now it will have a new button that lets you allow the executable to run.

These warnings will appear once for each of the executables inside the workflow as you use new features. Once you have authorized all of them, you won't see these warnings anymore until you install a new version.

Authorize All Executables

If you want to authorize all Bear Workflow executables at once or if you do not see the above security warnings but the workflow isn't working, you can do the following:

  1. Go to the Workflows section in Alfred Preferences
  2. Right click on Bear by drgrib and select Open in Terminal
  3. Copy this command and execute it:
xattr -rd com.apple.quarantine cmd

This should authorize all the Alfred Bear the executables and fix the security errors.

Install Rosetta

If your mac is based on an Apple Silicon chip (M1, M2, etc.), you need to have Rosetta installed on your system, otherwise Alfred workflows will fail silently.

Copy this command and execute in terminal to install Rosetta:

softwareupdate --install-rosetta