Title: Hearald Publisher
Author: fatherearthdev
Published: <strong>September 14, 2026</strong>
Last modified: September 14, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/hearald-publisher.svg)

# Hearald Publisher

 By [fatherearthdev](https://profiles.wordpress.org/fatherearthdev/)

[Download](https://downloads.wordpress.org/plugin/hearald-publisher.0.4.0.zip)

 * [Details](https://wordpress.org/plugins/hearald-publisher/#description)
 * [Reviews](https://wordpress.org/plugins/hearald-publisher/#reviews)
 *  [Installation](https://wordpress.org/plugins/hearald-publisher/#installation)
 * [Development](https://wordpress.org/plugins/hearald-publisher/#developers)

 [Support](https://wordpress.org/support/plugin/hearald-publisher/)

## Description

Hearald Publisher gives every article on your site a “Listen” button. When you publish,
the plugin sends the article’s text to the Hearald audio service, which narrates
it with a natural neural voice (Kokoro-82M) and returns an MP3. The MP3 is saved
into your own Media Library, and a clean, lightweight player appears above (or below)
your article — readers press play, and your writing meets them while they commute,
cook, or walk.

**Your audio is yours.** Every narration is a normal MP3 in your Media Library. 
It is served by your site, it keeps playing if you change plans or stop using Hearald,
and uninstalling the plugin leaves it where it is.

**What it does**

 * Generates an audio edition automatically on publish (optional), or per-article
   from the editor
 * Detects real edits by content: a meaningless save changes nothing; a material
   edit marks the audio “needs updating” (or regenerates automatically, your choice)
 * Seven curated voices (US and UK, male and female) with a per-article override
 * A Hearald dashboard: which articles have audio, their status, length and voice—
   plus plays, completions and minutes listened when you enable analytics
 * An Audio column and status filter on the Posts screen
 * A dependency-free player: seek, keyboard controls, playback speed, graceful when
   audio is unavailable
 * Player styling: your own accent colour, light/dark/follow-the-reader, and your
   theme’s font if you prefer it
 * `[hearald_player]` shortcode for manual placement
 * Hidden messages: set words large with `[hearald_mark]`, hide a phrase in their
   first letters, and let readers claim a code with `[hearald_hidden_message]`

**Plans**

 * **Free** — 5 articles a month. No card: get a free license key in under a minute.
 * **Publisher** — $19/month for 50 articles a month.
 * **Publisher Pro** — $50/month for 500 articles a month.

Plans count audio generations per license key per calendar month: publishing a new
article, or regenerating one whose words or voice changed, uses one. Regenerating
audio that already matches the article costs nothing. See https://forgehouse.app/
hearald/publisher/

**What it costs your readers: nothing.** The player is static assets served by your
site and one MP3 file. No reader accounts, no tracking scripts, no cookies.

**Listen analytics are opt-in and aggregate-only.** When enabled, your site counts
plays, completions and seconds listened per article — three numbers. No IPs, no 
user agents, no identifiers, no per-reader anything, ever.

### External service disclosure

This plugin relies on the Hearald audio service to synthesize speech. It does not
work without an account and connection to a service endpoint.

**What is sent, and when:** When you (or your auto-generate setting) request audio
for a post, the plugin transmits to the Hearald service (https://audio.forgehouse.
app, unless you set another endpoint under Advanced): the post’s published text 
content (title, headings, paragraphs, lists, quotes), the post ID, the chosen voice,
a salted non-reversible hash identifying your site, and your license key. Testing
the connection sends only your license key. Nothing is transmitted until you enter
a license key and request generation. Draft, pending and private posts are never
sent — generation is refused for anything unpublished. The plugin then downloads
the finished MP3 from the service into your Media Library.

**What is not sent:** reader data of any kind, user accounts, emails, comments, 
credentials, or content of posts you did not generate audio for.

**What the service stores:** the job record (site hash, post ID, post title, voice,
content hash, status), kept for 30 days, and the generated MP3 only until your site
has copied it — it is deleted as soon as your site collects it, and after 7 days
at most. The article text is held only while it waits in the queue and is being 
narrated, and is discarded when generation finishes. Your license key is stored 
only as a one-way hash, alongside your plan and monthly article count. Uninstalling
the plugin removes all plugin settings and post data from WordPress; the MP3s in
your Media Library stay unless you delete them.

**License checks (Gumroad):** Plans are sold through Gumroad. To confirm which plan
a license key belongs to, the Hearald service sends the key and the Hearald product
ID to Gumroad’s license verification API. No article content or site data is sent
to Gumroad. Gumroad terms: https://gumroad.com/terms — privacy: https://gumroad.
com/privacy

**Service provider:** Hearald — https://forgehouse.app/hearald/ — terms and privacy:
https://forgehouse.app/hearald/privacy/

The optional “Powered by Hearald” credit on the player is off by default and only
appears if you enable it.

## Installation

 1. Install and activate the plugin.
 2. Get a license key at https://forgehouse.app/hearald/publisher/ — free, or a paid
    plan.
 3. Go to **Hearald  Settings**, paste the license key from your receipt email, and
    press **Test connection**.
 4. Pick a default voice and player placement.
 5. Turn on auto-generate if you want every newly published post narrated automatically—
    or use the **Hearald Audio** box in the editor per article.

## FAQ

### What happens if I cancel or downgrade?

Everything already narrated stays in your Media Library and keeps playing — it is
your file, served by your site. Your key simply moves to the Free plan’s 5 articles
a month.

### Where are the audio files stored?

In your Media Library, attached to their article, named like `hearald-your-post-
slug-1a2b3c4d.mp3`. Regenerating an article replaces its old Hearald MP3; your own
media is never touched.

### Does this bundle an AI model or slow my site down?

No. Synthesis happens on the Hearald service. Your site sends text, polls in the
background via WP-Cron, and serves a small CSS/JS player only on pages that show
one.

### What happens when I edit an article?

The plugin hashes what would actually be spoken. Fixing a typo in a shortcode attribute
or re-saving changes nothing; changing the words marks the audio “needs updating”
so you decide — or regenerates automatically if you enabled that.

### How many articles do I get, and how do I know what’s left?

Free is 5 articles a month, Publisher is 50 and Publisher Pro is 500. **Hearald  
Settings** and the Hearald dashboard both show your plan and how many you have used
this month, so the limit is never a surprise. Counts reset on the 1st (UTC), and
regenerating audio that already matches an article is free.

### What is the hidden message feature?

An old writing trick with a payoff. Set a few words large through an article — `[
hearald_mark]kept[/hearald_mark]` — so their first letters spell a phrase, then 
drop `[hearald_hidden_message id="..."]` at the end. A reader types what they found,
your site checks it, and only a correct answer gets your code back. The answer is
never sent to the browser, so the hunt can’t be skipped by viewing the source. Set
the messages and codes under Hearald  Settings. Readers stay anonymous: the site
keeps two counters and a one-way hash of a guesser’s address for one minute so nobody
can machine-guess it.

### Can I change how the player looks?

Yes. Settings has an accent colour, a light / dark / follow-the-reader choice, and
an option to use your theme’s font instead of Hearald’s. Everything else is plain
CSS custom properties on `.hearald-player`, so a theme can restyle it completely.

### Can different articles use different voices?

Yes — the Hearald Audio box in the editor has a per-article voice override. Changing
the voice for an article with existing audio marks it “needs updating,” exactly 
like a content edit.

### Do readers get tracked?

No. Without analytics enabled, nothing is counted at all. With analytics enabled,
your site keeps three aggregate numbers per article (plays, completions, seconds
listened) — no identifiers of any kind.

### Does it work with the classic editor?

Yes. The editor integration is a standard meta box; it behaves identically in the
block and classic editors.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Hearald Publisher” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ fatherearthdev ](https://profiles.wordpress.org/fatherearthdev/)

[Translate “Hearald Publisher” into your language.](https://translate.wordpress.org/projects/wp-plugins/hearald-publisher)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hearald-publisher/),
check out the [SVN repository](https://plugins.svn.wordpress.org/hearald-publisher/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/hearald-publisher/)
by [RSS](https://plugins.trac.wordpress.org/log/hearald-publisher/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.4.0

 * Hidden messages: hide a phrase in an article and let readers claim a code for
   finding it
 * Your plan and how many articles you have left this month now appear in Settings
   and on the Hearald dashboard
 * Player styling: accent colour, light / dark / follow-the-reader, and an option
   to use your theme’s font
 * The player’s colours are CSS custom properties, so themes can restyle it completely

#### 0.3.1

 * Voices now carry the Hearald names — Wren, Juniper, Marlowe, Bram, Edith, Beatrix(
   new) and Alistair; sites that picked a voice keep the same one
 * Publishing and clicking “Generate audio” at the same time no longer asks for 
   the same audio twice
 * The editor’s Hearald Audio box updates itself after you publish

#### 0.3.0

 * Plans: Free, Publisher and Publisher Pro, activated with a license key
 * Audio is now saved into your Media Library and served by your site; the service
   deletes its copy once collected
 * Settings: connect with just a license key (the hosted service is the default;
   custom endpoint under Advanced)
 * “Regenerate” on audio that already matches the article reuses it and costs nothing
 * Clearer messages for unrecognised keys and monthly limits

#### 0.2.0

 * Hearald dashboard with status table, filters, and aggregate listen analytics (
   opt-in)
 * Per-article voice override
 * Audio column + status filter on the Posts screen
 * Connection tester with precise failure reporting
 * Player: buffering state, unavailable-audio state, reduced-motion support
 * Hardening: published-posts-only generation, safe remote requests, rate-limited
   analytics endpoint, multisite uninstall

#### 0.1.0

 * First release: automatic generation on publish, edit detection by content hash,
   editor meta box, frontend player, shortcode.

## Meta

 *  Version **0.4.0**
 *  Last updated **20 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [accessibility](https://wordpress.org/plugins/tags/accessibility/)[audio](https://wordpress.org/plugins/tags/audio/)
   [podcast](https://wordpress.org/plugins/tags/podcast/)[text to speech](https://wordpress.org/plugins/tags/text-to-speech/)
   [tts](https://wordpress.org/plugins/tags/tts/)
 *  [Advanced View](https://wordpress.org/plugins/hearald-publisher/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/hearald-publisher/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hearald-publisher/reviews/)

## Contributors

 *   [ fatherearthdev ](https://profiles.wordpress.org/fatherearthdev/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hearald-publisher/)