Youversion Suggest Alfred Versions Save

YVS v15 is a major release with welcome new features, improvements, and other fixes. Please note that release requires Alfred 5.5, and this version of the workflow cannot be backported to Alfred 4.

New Features

Preview Mode

YVS v15 introduces a fully-featured preview mode (using Alfred 5.5's new Text View)! Now, if you hold down the Shift key when actioning a result, you can preview the contents of the reference directly in Alfred! This preview mode replaces the old Quick Look functionality.

Once you're in the preview mode, you can then use the usual keyboard shortcuts to act on the reference, including Command+Enter for copying the contents to the clipboard, and Control+Enter for searching the reference on the web.

Universal Actions

YVS v15 brings integration with Alfred's Universal Actions feature, enabling you to pass any arbitrary text to the workflow when you select it within an app or on a webpage. To use this, you must enable the Workflow Universal Actions checkbox in Alfred Preferences, under Features > Universal Actions > Actions.

In particularly, there are two universal actions available:

1. Look up Bible address (e.g. if you select "Philippians 4:13")
2. Search phrase in Bible

Copy URL to clipboard

You can also now copy the URL of the selected reference to the clipboard by holding down the Option key while actioning the result. This can be useful if you want to share the YouVersion link to a particular reference, rather than the textual contents of the reference.

Improvements

Latest Bible data from YouVersion

YVS v15 comes bundled with the latest Bible data from the YouVersion website. For details on what's changed, please see the diff on the youversion-suggest-data repository.

Error handling when setting preferences

If, for any reason, you encounter an error while trying to change a preference (i.e. using the yvset keyword), YVS v15 now spawns a notification indicating that it failed to set the preference.

Error handling when clearing cache

If, for any reason, you encounter an error while trying to clear the workflow cache (i.e. using the yvclearcache keyword), YVS v15 now spawns a notification indicating that it failed to clear the cache.

Housekeeping

Cleaned up workflow objects

The entire workflow has been rewired to utilize Alfred's External Triggers feature, which eliminates the tangled mess of connections between the various workflow objects. This means YVS v15 is significantly more maintainable and easier to tweak (if you are the adventurous type)!

Refactored test suite

The test suite has been refactored to be class-based, thus adhering to the conventional paradigm for writing unit tests with the unittest module. Additional tests have also been added for the new Preview Mode, as well as for other specific edge cases (e.g. related to reference formats).

• Fixed a serious bug where Copy to Clipboard functionality broke completely due to recent changes YouVersion made to their web app

• Fixed a bug where line breaks within verses would not be preserved (e.g. Psalm 23:1 in the NASB1995)

• Added language support for Ukrainian (ukr)
  • To use, look for Українська in the Language dropdown for the "Set Bible Preferences" command
  • CUV has been set as the default version/translation for this language, but if you want to change it, feel free

• Fixes a bug where extraneous whitespace would appear in verse content containing italicized words
  • Versions like NKJV (and perhaps NASB as well) were particular affected; if you use these versions, you are encouraged to update

• Fixes a small bug where the verse content would not display for each yvsearch result

• Fixes a bug where extraneous content may end up in copied chapter content

• Fixes a regression introduced in v14.1.1 that impacts the copying of verse content for select verses
• Version v14.1.1 already fixes an issue with copying verse content to the clipboard, so if you are using v14.1.1 or older, you will definitely want to update

• Fixes a bug where the content individual verses (or verse ranges) could not be copied to the clipboard
• Fixes a bug where the internal caching optimizations introduced in v14.1.0 (see here) was not actually operating correctly

• Fixed a critical bug where the "Copy to Clipboard" functionality would return an error for verses that have not been copied previously (#25); all users are encouraged to upgrade to this release
• The internal caching mechanism has been optimized to use up to 70% less disk space