This is an overcomplicated and feature-packed plugin for Flow Launcher that lets you easily see the definitions (among other things) of words using wordnik.
- Get an API Key
- Installation
- Features
- Settings Menu
To get an API key, head to developer.wordnik.com, and create an account. Once you've created your account, you'll be able to fill out a form to request an api key.
To Install Wordnik Dictionary through Flow's Plugin Manager, run the following command: pm install wordnik dictionary.
Warning
This method is not recommended, only do this if you know what your doing.
- Download the zipped release file.
To download a previously released version, head to the releases page, find the version you want, and download the zip file.
- Extract the zip file into your plugins folder.
You can access your userdata folder through the Flow Launcher UserData Folder command in the system commands plugin, from there go into the Plugins folder, and create a new folder for your release. Extract the contents of the zip folder into the new folder you've made.
- Restart Flow Launcher
Finally you want to restart flow launcher. You can do this via the Restart Flow Launcher command in the system commands plugin.
- Head to your plugins folder.
You can access your userdata folder through the Flow Launcher UserData Folder command in the system commands plugin, from there go into the Plugins folder.
- Clone the repository.
Note
git must be installed for this
Now you must clone the repository, which can be done with the following command: git clone https://github.com/cibere/Flow.Launcher.Plugin.WordNikDictionary.
- Setup your environment
Head into the newly created folder containing the plugin, and create and activate a venv. Then run the install_packages.bat file from that console. That file will update pip, install the runtime libraries, and install the development libraries.
- Restart Flow Launcher
Finally you want to restart flow launcher. You can do this via the Restart Flow Launcher command in the system commands plugin.
- Get the definition of a word
- Get information about definition of a word
- Search Modifiers
- Autocomplete Miss-spelled Words
- Advanced Error Handler
Get a list of definitions for your word from various sources. Syntax: def word
Get information about a certain definition, and easy access to the source. This is a context menu that is avalible for all definitions.
You can use search modifiers to filter your results by part of speech, or to get different types of information about a word. Search modifiers have the following syntax: word!modifier
You can filter results by parts of speech by inputting the part of speech as a modifier.
Syntax: word!part_of_speech.
List of acceptable parts of speech modifiers:
noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive
To select a part of speech from the list of acceptable ones, you can use the def word!select-pos command.
We can use the syllables search modifier to get the syllables of a word. Syntax: def word!syllables
To find the categories of avalible similiar words for a given word, use the following command: def word!similiar. To see all of the words in a given category, see the section below.
To find all of the words that are similiar to a word in a specific category, use the following command: def word!rel-category. For a list of avalible categories for a given word, see the above section.
To see a list of available search modifiers available, use the def word!select-modifier command. From there you have quick access to the various modifiers, and the Parts of Speech Selector Menu.
You can get the scrabble score of a word by using the scrabble modifier like so: def word!scrabble. If a word is invalid or not found, a score of 0 is shown.
If you misspell a word, wordnik dictionary uses a list of over 370 thousand words to try and figure out what you were trying to spell, and ranks them by how certain it is. Though the source for the list of words and definitions are different! So there may be differences in the data.
Note
When attempting to use this feature for the first time, you will be prompted to either open up the settings menu to choose the path of a custom word list file, or download one from dwyl on github.
Expected errors will return a short, simple, and stylish error message.
When unexpected errors occur, our error handler redirects it to the logs and prompts you to notify us by creating a github issue or discord thread with the logfile.
When an invalid advanced search modifier is given, a simple error message is shown, with quick access to the Search Modifier Selection Menu
- Action Keyword
The keyword that activates the plugin, defaults to def with the stable release, and ddef with the dev version.
Warning
Changing this is NOT recommended. Currently, many QOL features require these keywords to stay at the default, otherwise some query changing options will not work properly.
- Wordnik API Key
Head to https://developer.wordnik.com to get your API key.
- Number of results to display.
Number of results to display. Defaults to 20, you must give an integer.
- Autocomplete Miss-spelled Words
If marked yes, wordnik dictionary will attempt to find which word you were trying to spell if a word was not found. This is toggleable because it can be really slow, and you may just want to know if a word was found or not. Defaults to checked.
- Location of word list file
If you want to use a custom list of words for the autocomplete misspelling feature, you can. Just put the path to the file here, and reload plugin data. Make sure each word is on it's on line. Default is blank, and blank means the default file is used. This setting on does anything if the Autocomplete miss-spelled words setting is checked.
