whatisgithub

What is spiel?

preet01/spiel — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

Spiel is a Chrome extension that reads articles and PDFs aloud using a local AI voice engine on your Mac, with no accounts or cloud servers involved.

Mindmap

mindmap
  root((spiel))
    What it does
      Reads articles aloud
      Reads PDFs aloud
      Word by word highlighting
      Click to read from point
    Tech stack
      TypeScript
      Chrome extension
      Kokoro voice model
      FastAPI backend
    Use cases
      Free Speechify alternative
      Offline reading aid
      Research paper listening
    Privacy
      Fully local processing
      No accounts
      No telemetry

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Listen to a web article or research PDF read aloud instead of reading it yourself.

USE CASE 2

Have text read on a Mac with no internet connection once the voice engine is installed.

USE CASE 3

Select a specific passage on any page and hear just that part read back.

What is it built with?

TypeScriptChrome ExtensionKokoroFastAPIpdf.js

How does it compare?

preet01/spiel4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires a Mac with Apple Silicon and running a one-time Terminal install script for the voice engine.

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

So what is it?

Spiel is a Chrome extension that reads articles and PDFs out loud using a natural sounding AI voice, and it does all of this entirely on your own Mac. There is no account to create, no subscription fee, and no data sent to a company's servers. It is built as a free alternative to paid read aloud services like Speechify, and it keeps working even with Wi-Fi turned off, since the voice engine never leaves your computer. The extension lets you open any article or PDF and press play, then follows along with word by word highlighting as it reads. You can click anywhere in the text to jump the reading to that spot, or select a specific passage to hear just that part. There are four voice options covering American and British accents in male and female versions, playback speed up to three times normal, and a running estimate of how much time is left at your chosen speed. It also has a dark mode that matches whatever page you are reading, and it can be told to skip over things like web links or bracketed references. Getting it running takes two steps. First you add the extension from the Chrome Web Store, or install it manually from a downloaded file if you prefer. Second, you run a short installer command in your Mac's Terminal app, which sets up a separate voice engine called Kokoro that generates the actual speech. This installer downloads the necessary files, sets the voice engine to start automatically whenever your Mac starts up, and confirms everything works by having your Mac say a test sentence out loud. Behind the scenes, the extension pulls the readable text out of a page or PDF on your own device, sends it to the local voice engine running only on your machine at a private local address, and plays back the resulting audio with highlighting timed to match the words being spoken. Because the voice engine only listens on your own machine, and because no analytics are collected, the only time Spiel connects to the internet at all is during that one time installation of the voice engine files. Right now Spiel only supports Macs with Apple Silicon chips, though support for Intel Macs, Windows, and Linux is planned. The project is released under the MIT license and built using several other open source components credited in its documentation.

Copy-paste prompts

Prompt 1
Walk me through installing Spiel's Chrome extension and its local Kokoro voice engine on macOS.
Prompt 2
Explain how Spiel keeps text-to-speech entirely local by running the voice engine at 127.0.0.1.
Prompt 3
How does Spiel extract readable text from a webpage or PDF before sending it to the voice engine?
Prompt 4
What voice and speed options does Spiel offer, and how do I switch between them while reading?

Frequently asked questions

What is spiel?

Spiel is a Chrome extension that reads articles and PDFs aloud using a local AI voice engine on your Mac, with no accounts or cloud servers involved.

What language is spiel written in?

Mainly TypeScript. The stack also includes TypeScript, Chrome Extension, Kokoro.

What license does spiel use?

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is spiel to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is spiel for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.