Title: Listenability Author: Weston Ruter Published: September 1, 2015 Last modified: September 24, 2015 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/listenability.svg) # Listenability By [Weston Ruter](https://profiles.wordpress.org/westonruter/) [Download](https://downloads.wordpress.org/plugin/listenability.zip) * [Details](https://pcd.wordpress.org/plugins/listenability/#description) * [Reviews](https://pcd.wordpress.org/plugins/listenability/#reviews) * [Installation](https://pcd.wordpress.org/plugins/listenability/#installation) * [Development](https://pcd.wordpress.org/plugins/listenability/#developers) [Support](https://wordpress.org/support/plugin/listenability/) ## Description This plugin allows you to create text-to-speech podcasts of your posts, with the content from embedded URLs supplied by Readability’s Parser API. It aims to be a open self-hosted re-incarnation of defunct [SoundGecko](http://soundgecko.com/) service. When a [Readability Parser API](https://www.readability.com/developers/api/parser) key is supplied, a post which gets saved with a bare URL as its content will have this content prepended with the content that Readability extracts from the page at that URL. This allows you to import an article’s full contents into your podcast just by saving a post with a URL in its content (e.g. by sharing an article URL to your blog via Jetpack’s [post by email](http://jetpack.me/support/post-by-email/)). In addition to supplying a URL for the content you want in the podcast, you can also just add the content directly to the post itself without any corresponding article URL, and this content will be converted to TTS (text-to-speech) audio instead. You can also, of course, attach an MP3 to a post and it will be used for the podcast instead of TTS-generated audio from the post content or enclosed URL. The TTS audio is generated by a Mac regularly connected to the Internet (e.g. your Mac). It generates the article audio MP3 using the OS X `say` command. You can configure the voice and the rate for the speech audio generated. (Use of the OS X voice is not required; an alternative TTS solution may be devised instead.) The MP3 gets attached to its corresponding post, being prepended to the post content by means of an `audio` shortcode. A new `listenability` permalink endpoint is introduced which contains the text content of a given post presented in a textual form which can be ready by a text-to-speech( TTS) engine. It is specifically designed to be read by the speech synthesis engine in OS X as it includes [embedded speech commands](https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/SpeechSynthesisProgrammingGuide/FineTuning/FineTuning.html). The RSS2 feed includes a new `enclosure` element containing the URL for this endpoint with the ad hoc content type `text/plain+embedded-speech-commands`. #### Restrictions Note that the Readability Parser API is freely available for _non-commercial use_. The article content fetched by Readability and inserted into your posts is copyrighted by their respective authors (attribution gets included in the post content). Likewise, the speech audio generated by OS X is for [personal, non-commercial use](http://apple.stackexchange.com/a/43300/28836). It is therefore key that there be _no advertising_ employed on the WordPress install that uses this plugin. Because of the non-commercial and personal usage imposed by these dependencies, it is recommended that this plugin be used on your own personal dedicated podcast blog that is set to block search engines, that is unless you have obtained a commercial Readability license and are not using TTS audio generated by OS X. #### Dependencies * [Readability Parser API](https://www.readability.com/developers/api/parser) key. This can also be supplied in `wp-config.php` via the `READABILITY_PARSER_API_KEY` constant. * Mac computer (OS X) that is regularly connected to the Internet (e.g. your computer), with [SoX](http://sox.sourceforge.net/) installed (e.g. via [Homebrew](http://brew.sh/)). * (Optional) [Jetpack](http://jetpack.me/) plugin, for the [Post by Email](http://jetpack.me/support/post-by-email/) feature. #### Extensions The plugin includes actions and filters primarily for customizing the formatting of the text for the text-to-speech engine. You may use these hooks to improve how the TTS engine reads the text on a given site, for instance by stripping out footnotes or removing image captions. For an example of such a plugin, see the [sample plugin which improves formatting of Wikipedia articles](https://gist.github.com/westonruter/dfaa45b026a2bb6a36e0). See the [plugin source code](https://github.com/westonruter/wp-listenability/tree/master/php) to see which additional plugin hooks are available. #### Contributing This plugin is [developed on GitHub](https://github.com/westonruter/wp-listenability). Report [issues](https://github.com/westonruter/wp-listenability/issues) there. [Pull requests](https://github.com/westonruter/wp-listenability/pulls) welcome. #### License GPLv2 license. Copyright 2015 by Weston Ruter. ## Installation Upon activation of the plugin, navigate to the Options > Listenability admin page to supply the Readability API key and find technical instructions for how to set up your Mac to generate the speech audio for your podcast. ## Reviews ![](https://secure.gravatar.com/avatar/d2f4e91638d578a01f244972f5efe0e1aba1c38e4e07ae9b34c46c0efd0d5bf1? s=60&d=retro&r=g) ### 󠀁[Need any demo](https://wordpress.org/support/topic/need-any-demo/)󠁿 [](https://profiles.wordpress.org/kendy_nd/) September 3, 2016 Please give us any demo to more understand your plugin and the users will easy to decide intall or not 🙂 [ Read all 1 review ](https://wordpress.org/support/plugin/listenability/reviews/) ## Contributors & Developers “Listenability” is open source software. The following people have contributed to this plugin. Contributors * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) [Translate “Listenability” into your language.](https://translate.wordpress.org/projects/wp-plugins/listenability) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/listenability/), check out the [SVN repository](https://plugins.svn.wordpress.org/listenability/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/listenability/) by [RSS](https://plugins.trac.wordpress.org/log/listenability/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.1 * Improve handling of Readability API errors by sending post back to draft. * Remove audio elements from TTS text. #### 0.1 Initial release. ## Meta * Version **0.1.1** * Last updated **11 years ago** * Active installations **10+** * WordPress version ** 4.3 or higher ** * Tested up to **4.3.34** * Language * [English (US)](https://wordpress.org/plugins/listenability/) * Tags * [podcast](https://pcd.wordpress.org/plugins/tags/podcast/)[speech](https://pcd.wordpress.org/plugins/tags/speech/) [tts](https://pcd.wordpress.org/plugins/tags/tts/) * [Advanced View](https://pcd.wordpress.org/plugins/listenability/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/listenability/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/listenability/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/listenability/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/listenability/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/listenability/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/listenability/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/listenability/reviews/) ## Contributors * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/listenability/)