Skip to content

Ghost Voice Reader: a free Listen button for posts

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 supported posts. It appears in the lower-left corner. A post needs at least 40 words of readable text. Readers can play, pause, and resume the post. The script uses the browser’s built-in voice. 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/[email protected]/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.
  6. Select Listen and check that you hear the post. Test Pause, then resume playback.

The reader detects common Ghost post layouts automatically. It keeps its own styles separate from your theme’s styles. The browser must support speech. The voice you hear depends on the browser and device.

If the button is missing

Check that you saved the snippet in Site Footer. Open a post, rather than a regular page. Try a longer post. The button stays hidden below 40 readable words. It also stays hidden if the browser cannot play speech.

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 in the post toolbar, see these themes:

View the source and configuration options on GitHub.

More from the Blog

Latest Ghost Themes