The workflow offers a few options and links under the bkconf keyword, but it's primarily configured via its configuration sheet (the [x] button in Alfred Preferences).
Keyword: bkconf
If a newer version of the workflow is available, "Workflow Update Available" is shown. Action this item to update the workflow.
Whether you've authorised the workflow to access your Goodreads account via OAuth. If "Workflow Not Authorised" is shown, action the item to go to goodreads.com and authorise the workflow.
You can deauthorise the workflow (i.e. delete the OAuth tokens) with ⌘↩.
Open custom scripts folder (see scripts for details).
Open this documentation in your browser.
Open workflow issue tracker in your browser.
Open workflow issue tracker in your browser.
There are only a couple of configuration options by default, but you can add more to customise the workflow.
| Variable | Default Value | Description |
|---|---|---|
ACTION_DEFAULT |
Open Book Page |
The script run when you press ↩ on a book item. |
ACTION_ALT |
View Series |
The script run when you press ⌥↩ on a book item. |
EXPORT_DETAILS |
false |
Whether all book details should be fetched before running a script (see scripts for details) |
USER_ID |
Your Goodreads ID. Saved by the workflow when you log in. | |
USER_NAME |
Your Goodreads username. Saved by the workflow when you log in. |
The actions you can perform on books are primarily defined by scripts. Several scripts are included with the workflow (in the scripts subdirectory of the workflow's folder), and you can also add your own (see scripts).
You can assign any built-in or custom script a hotkey via the configuration by creating a variable with a name of the form ACTION_<KEY> and the name of the script (without file extension) as its value. For example:
| Variable | Value | Description |
|---|---|---|
ACTION_CTRL |
Mark as Read |
Run the built-in Mark as Read.zsh script when you press ^↩ on a book item |
ACTION_CTRL_SHIFT |
View Similar Books |
Run the built-in View Similar Books.zsh script when you press ^⇧↩ on a book item |
ACTION_CMD_OPT_CTRL |
My Custom Script |
Run your custom script named My Custom Script when you press ^⌥⌘↩ on a book item |
You can combine modifier keys arbitrarily.
To simplify adding custom hotkeys, hitting ⌘C on an action in the "All Actions…" list (⌘↩ on a book item) will copy its name to the clipboard for easy pasting into the configuration sheet.