Spellbook

FAQs

[Spellbook Search] Spellbook uses an OAuth implementation to request access to your Evernote account. When you click the green link to 'Generate an account token for your Evernote account', a browser window will open the Evernote website. Once you sign in to your account, you can give consent to allow the Spellbook plugin access to the account. You can also specify the duration or 'life-to-live' time of the access token. After you give consent, you will be redirected to the Spellbook website where you can copy your token and provide it to Spellbook in your IDE.
If OAuth doesn't work for you, you can always contact Evernote support and request a developer token for your account. Spellbook can work with developer access tokens as well.

[Spellbook Search] You can search your Evernote account using Spellbook's search filter. The available search filters are described below.

AND / OR Filter:
The AND/OR search selector works just like and/or operators in any programming language. The selector will filter the results of your search as follows:
  • AND: will search for notes that match ALL of the specified search parameters. Only notes that match ALL of the specified search parameters will be returned in the results. For example - "Find notes that contain the keyword 'static' AND whose title contains the word implementation AND are tagged with 'Java'."
  • OR: will search for notes that match ANY of the specified search parameters. Notes that match ANY of the specified search parameters will be returned in the search results. For example - "Find notes that include the keyword text 'Linked List' OR are tagged with 'JavaScript Snippets'."
NOTE: if you are only planning to search by notebook ALWAYS use the 'AND' selector. Choosing the 'OR' selector in this scenario may give you weird results.

By Content Keyword:
The content keyword search parameter will filter your search by specific words or phrases. Your Evernote account will be searched for notes that contain the specified words or phrases. To search for a specific word, just type the word. To search for a specific phrase wrap the phrase in quotation marks. To search for multiple keywords or phrases, separate each word or phrase with a space. You can also use wildcards (*) at the beginning and ending of words and phrases to match notes that start or end with the word or phrase.
Example:
  • fetchtype "many to many" cascade*
    • Will match notes whose content contains the word 'fetchtype' AND/OR the phrase'many to many' AND/OR a word that begins with 'cascade'.
By Notebook:
The notebook search parameter will filter your search by notebook. Only notes that are contained within the specified notebook will be returned in the results. The notebook search parameter drop down list is populated with the list of notebooks associated with this account.
NOTE: if you only want to search by notebook ALWAYS use the ''AND' selector. Choosing the 'OR' selector in this scenario may give you weird results.

By Note Title: The note title search parameter will filter your search by specific words or phrases in a note's title. Your Evernote account will be searched for notes that contain the specified words or phrases in their title. To search for a specific word, just type the word. To search for a specific phrase wrap the phrase in quotation marks. To search for multiple keywords or phrases, separate each word or phrase with a space. You can also use wildcards (*) at the beginning and ending of words and phrases to match notes that start or end with the word or phrase.
Example:
  • fetchtype "many to many" cascade*
    • Will match notes that whose title contains the word 'fetchtype' AND/OR the phrase'many to many' AND/OR a word that begins with 'cascade
By Tags: The tags search parameter will filter your search by tag. Only notes that are tagged with the selected tag(s) will be returned in the results. The tags search parameter selection list is populated with the list of ALL tags associated with this account.

If you get a 'NOT FOUND' error when trying to access a notebook or note with Spellbook, it usually means that the notebook or note you were trying to access was removed/deleted from your Evernote account outside of Spellbook (i.e. the notebook or note was deleted using the Evernote web client, or mobile app, etc.). The notebook tree for your Evernote account in Spellbook's UI IS NOT 'auto-synced' with the Evernote service. Manual 'sync' is required. Simply refresh the notebook tree or the notebook node to sync it with what data is currently in your account.

NOTE: this also applies to notebooks or notes that are created or updated outside of Spellbook.

The Evernote SDK/API used by Spellbook for integration with the Evernote web service implements a rate limit on third party apps and services to ensure optimal performance. Rate limits are applied against the API on a per user basis, meaning Spellbook usage by other users DOES NOT affect your specific account rate limit. The Spellbook codebase is written in such a way as to limit the amount of calls to Evernote's API as much as possible. If you do encounter this error, typically you just have to wait until the rate limit duration expires before attempting to execute another request against the API. Your wait time (rate limit duration) can be found in the rate limit error details.

Just generate a new access token for your Evernote account using our OAuth implementation and provide it to Spellbook.

[Spellbook Storage] OF COURSE NOT! When you add your Evernote account to Spellbook, the access token and unique account name you specified are stored in a local persistent storage associated with the JetBrains IDE you are using. You can quickly reload a previously added account from persistent storage by using the 'Load Account' action, (the folder icon) in the Spellbook tool window toolbar. If you no longer want the account in persistent storage, use the 'Remove Account' action, (the minus icon), in the Spellbook tool window toolbar.
Keep in mind, this storage is LOCAL, so the accounts stored on one computer will not be available across different computers. But you can create as many access tokens for the same Evernote account as needed for each computer you use if you'd like or you could always just copy the access token from one machine to the next...

[Spellbook Storage] There are 2 ways to close an open Evernote account tab in Spellbook:
  1. Right click the account tab and select 'Close Tab'. This is the most convenient way to close the account tab as it will close the open tab, BUT will keep the account info (i.e. the Evernote account access token and account name you originally specified) in a local persistent storage associated with the JetBrains IDE you are using. This allows you to easily re-open the account tab, using the 'Load Account' action (the folder icon) in the Spellbook tool window toolbar, without having to re-specify the Evernote account access token.
  2. Click the 'Remove Account' action, (the minus icon) in the Spellbook tool window toolbar and select the name of the open account tab that you wish to close. Closing the account tab in this manner will close the tab, BUT ALSO remove the account info (i.e. the Evernote access token and account name you originally specified) from the IDE's local persistent storage. If you want to re-open another tab containing this account data, you will need to specify the Evernote account access token again.