Weston Ruter

<p>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 <a href="http://soundgecko.com/" rel="nofollow ugc">SoundGecko</a> service.</p>
<p>When a <a href="https://www.readability.com/developers/api/parser" rel="nofollow ugc">Readability Parser API</a> 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 <a href="http://jetpack.me/support/post-by-email/" rel="nofollow ugc">post by email</a>).</p>
<p>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.</p>
<p>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 <code>say</code> 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 <code>audio</code> shortcode.</p>
<p>A new <code>listenability</code> 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 <a href="https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/SpeechSynthesisProgrammingGuide/FineTuning/FineTuning.html" rel="nofollow ugc">embedded speech commands</a>. The RSS2 feed includes a new <code>enclosure</code> element containing the URL for this endpoint with the ad hoc content type <code>text/plain+embedded-speech-commands</code>.</p>
<h4>Restrictions</h4>
<p>Note that the Readability Parser API is freely available for <em>non-commercial use</em>. 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 <a href="http://apple.stackexchange.com/a/43300/28836" rel="nofollow ugc">personal, non-commercial use</a>. It is therefore key that there be <em>no advertising</em> 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.</p>
<h4>Dependencies</h4>
<ul>
<li><a href="https://www.readability.com/developers/api/parser" rel="nofollow ugc">Readability Parser API</a> key. This can also be supplied in <code>wp-config.php</code> via the <code>READABILITY_PARSER_API_KEY</code> constant.</li>
<li>Mac computer (OS X) that is regularly connected to the Internet (e.g. your computer), with <a href="http://sox.sourceforge.net/" rel="nofollow ugc">SoX</a> installed (e.g. via <a href="http://brew.sh/" rel="nofollow ugc">Homebrew</a>).</li>
<li>(Optional) <a href="http://jetpack.me/" rel="nofollow ugc">Jetpack</a> plugin, for the <a href="http://jetpack.me/support/post-by-email/" rel="nofollow ugc">Post by Email</a> feature.</li>
</ul>
<h4>Extensions</h4>
<p>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 <a href="https://gist.github.com/westonruter/dfaa45b026a2bb6a36e0" rel="nofollow ugc">sample plugin which improves formatting of Wikipedia articles</a>.</p>
<p>See the <a href="https://github.com/westonruter/wp-listenability/tree/master/php" rel="nofollow ugc">plugin source code</a> to see which additional plugin hooks are available.</p>
<h4>Contributing</h4>
<p>This plugin is <a href="https://github.com/westonruter/wp-listenability" rel="nofollow ugc">developed on GitHub</a>. Report <a href="https://github.com/westonruter/wp-listenability/issues" rel="nofollow ugc">issues</a> there. <a href="https://github.com/westonruter/wp-listenability/pulls" rel="nofollow ugc">Pull requests</a> welcome.</p>
<h4>License</h4>
<p>GPLv2 license. Copyright 2015 by Weston Ruter.</p>


Listenability

Create a text-to-speech podcast of your posts, with the content from embedded URLs supplied by Readability. Open re-incarnation of SoundGecko.

webinista

<p>Webinista WreadIt <a href="https://wreadit.webinista.com" rel="nofollow ugc">https://wreadit.webinista.com</a></p>
<p>A WordPress plugin for creating audio versions of your posts using Amazon Polly.</p>
<p>Current version: v1.2.0 <a href="https://github.com/webinista/webinista-wreadit/releases/" rel="nofollow ugc">See all releases</a>.</p>
<p>You can also view, edit, or download the <a href="https://github.com/webinista/webinista-wreadit/" rel="nofollow ugc">source code</a> from GitHub.</p>
<h4>License</h4>
<p>Webinista WreadIt is licensed under the terms of the GNU General Public License, version 3. Some of its dependencies use the MIT 2.0 and Apache 2.0 licenses.</p>
<pre><code>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
</code></pre>
<h4>Prerequisites</h4>
<p>This plugin assumes that you are familiar with <a href="https://aws.amazon.com/" rel="nofollow ugc">Amazon Web Services</a> and that you have an account. You will need:</p>
<ul>
<li>An Amazon Simple Storage Service (S3) bucket.</li>
<li>An IAM user with full access to Polly and read/write access to the S3 bucket.</li>
<li>A key ID and Secret Access Key for the IAM user.</li>
</ul>
<h3>Development</h3>
<p>You can also build this plugin from source. This requires having <a href="https://nodejs.org/" rel="nofollow ugc">Node</a>, PHP, and <a href="https://getcomposer.org/" rel="nofollow ugc">Composer</a> available on your system.</p>
<ol>
<li>Clone the GitHub repo https://github.com/webinista/webinista-wreadit</li>
<li>From <code>webinista-wreadit</code> directory, run the following commands:
<ol>
<li><code>npm install</code> to install the JavaScript dependencies for the front-end.</li>
<li><code>composer install</code> to install PHP dependencies. You may also need to install the <a href="https://github.com/humbug/php-scoper/blob/main/docs/installation.md#composer" rel="nofollow ugc">php-scoper plugin</a> using <code>composer bin php-scoper require --dev humbug/php-scoper</code>.</li>
<li>Run the <code>build-wreadit-aws3.sh</code> script. This script downloads the latest version of the AWS SDK for PHP, extracts the relevant interfaces and common files, and scopes it to the project’s name space.</li>
</ol>
</li>
<li>Use <code>npm run build</code> to generate the front-end plugin files.</li>
<li>Upload the <code>webinista-wreadit</code> directory to <code>/wp-content/plugins/</code>.</li>
</ol>
<p>Activate the plugin and add your credentials before using.</p>
<h3>External services</h3>
<p>This plugin connects to Amazon Polly, and Amazon S3. Clicking the <em>Generate Audio Version</em> button sends the following data to Amazon Polly:</p>
<ul>
<li>The title and text of the blog post.</li>
<li>The slug of the blog post.</li>
<li>The <em>display name</em> of the post’s author. (Manage using the <em>Display name publicly as</em> setting on the <em>Edit User</em> screen.)</li>
<li>Your AWS Key ID.</li>
<li>Your Secret Access Key.</li>
<li>The name of your S3 bucket.</li>
</ul>
<p>Read Amazon’s <a href="https://aws.amazon.com/polly/faqs/#topic-2" rel="nofollow ugc">Polly FAQs</a>,<br />
general <a href="https://aws.amazon.com/compliance/data-privacy-faq/" rel="nofollow ugc">Data Privacy FAQs</a>, and <a href="https://aws.amazon.com/privacy/" rel="nofollow ugc">AWS Privacy Notice</a> to understand how Amazon uses your data. Read the <a href="https://aws.amazon.com/agreement/" rel="nofollow ugc">AWS Customer Agreement</a> and <a href="https://aws.amazon.com/service-terms/" rel="nofollow ugc">AWS Service Terms</a> to understand your rights and obligations with regard to Amazon’s services.</p>
<p>Amazon Polly requires your Key ID and Secret Access Key in order to authenticate the request. Amazon Polly saves the generated audio file to your S3 bucket.</p>
<p>Webinista WreadIt uses <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html" rel="nofollow ugc">S3’s virtual hosting</a>. URLs for audio files use the pattern shown below, unless you’ve set a custom domain.</p>
<pre><code>https://<bucket name>.s3.<region code>.amazonaws.com/<your optional prefix/><file name>
</code></pre>
<p>For example, if your bucket name is <code>myblogsaudio</code>, your bucket region is <code>us-east-2</code>, and you’ve set a <code>media/</code> prefix, your audio URLs will begin with  <code>https://myblogsaudio.s3.us-east-2.amazonaws.com/media/</code>.</p>
<p>File names begin with the slug of each blog post. Amazon Polly also appends a unique identifier to the name.</p>
<p><em>Audio files must be publicly readable</em> to be available to your listeners.</p>


Webinista WreadIt

A text-to-speech plugin for WordPress that uses Amazon Polly.

Listenability vs Webinista WreadIt