Skip to content

Ghost Voice Reader: A Free Post Listen Button

By Ahmad Ajmi

I made Ghost Voice Reader, a free and open-source script that lets readers listen to Ghost posts.

The script adds a floating Listen button to the lower-left corner of supported posts with at least 40 words of readable text. Readers can play, pause, and resume the post. The script uses the browser’s built-in voice, so you do not need an account, an API key, or an external speech service.

Ghost Voice Reader’s floating Listen button beside article text
The standalone Listen button on a demonstration article.

Add It to Ghost

  1. Open Ghost Admin → Settings → Advanced → Code Injection.
  2. Paste this code into Site Footer:

    <script
      src="https://cdn.jsdelivr.net/gh/aspirethemes/ghost-voice-reader@v1.0.0/dist/ghost-voice-reader.min.js"
      defer
    ></script>
    
  3. Select Save.
  4. Open a post with at least 40 words of readable text.
  5. Confirm that the floating Listen button appears in the lower-left corner.

The reader finds common Ghost post layouts automatically and stays separate from your theme styles. It needs the browser’s speech support; the available voice depends on the browser and device.

If the Button Is Missing

Check that you saved the snippet in Site Footer and opened a post rather than a regular page. Try a longer post: the button stays hidden when it finds fewer than 40 readable words. It also stays hidden if browser speech is unavailable.

If it still does not appear, contact me with your theme name, browser and post address. Some themes need a different way to locate the article text.

Remove the Reader

Delete the Voice Reader snippet from Site Footer and save. Preserve any other code in that field; your posts do not need editing.

Themes with a Built-in Voice Reader

For a voice reader inside the post toolbar, see Siwa for personal publications, Hanoi for visual magazines and Taba for news and magazine publishers.

View the source and configuration options on GitHub.

More from the Blog

Latest Ghost Themes