kglitchy/speak-it
Watch
1
0
Fork
You've already forked speak-it
 1
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions
No description
16 commits 1 branch 0 tags 426 KiB
  • JavaScript 93.2%
  • Python 2.1%
  • Shell 1.8%
  • CSS 1.6%
  • Makefile 0.7%
  • Other 0.6%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Katie Mulliken 6fbbea5c7e Read wrapped lines on forge pages as whole sentences 
GitHub, GitLab and Forgejo render each line of hard-wrapped text with a line
break, which ended a sentence mid-way ("under a version named. after its
SHA-256"). In forge descriptions and comments a line break now continues
the sentence; elsewhere it still separates lines of poems and addresses.

Forgejo titles are read without the issue number after them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 05:36:11 -04:00
src Read wrapped lines on forge pages as whole sentences 2026-10-17 05:36:11 -04:00
tools Download the model on first use instead of shipping it 2026-10-16 22:56:01 +00:00
.gitignore Download the model on first use instead of shipping it 2026-10-16 22:56:01 +00:00
AGENTS.md Change the Firefox extension ID to speak-it@mulliken.net 2026-10-16 19:10:20 -04:00
Makefile Add make pack-chrome 2026-10-16 19:17:29 -04:00
README.md Add a Firefox download button to the README 2026-10-16 19:17:29 -04:00

README.md

Speak It

A Chrome and Firefox extension that reads web pages aloud with Kokoro-82M. Everything runs in the browser: no server, and no text or audio leaves your computer. The first time it reads, it downloads the speech model (325 MB) and keeps it.

Install

Download for Firefox

Firefox 142 or later: click the button and allow the installation. This version is signed, so it stays installed.

To build it yourself (the only way for Chrome), you need uv, npm and curl.

make                          # download the voices and libraries
make install                  # Chrome
make install BROWSER=firefox  # Firefox 142 or later

make install opens the browser's extensions page, copies the path to load to the clipboard and prints the steps. Chrome keeps the extension installed. Firefox removes it when it quits, so run make install BROWSER=firefox again after restarting Firefox. Then pin Speak It to the toolbar.

Reading needs WebGPU to be fast. Without it, Chrome is slower and Firefox can't keep up with playback. Firefox has WebGPU on Windows and Apple-silicon Macs only.

Using it

  • Toolbar popup: read the page or the selection, and pick the voice and speed.
  • Right-click: Read selection aloud, or Read page from here.
  • Shortcuts: Alt+Shift+R reads the selection (or the page), Alt+Shift+P pauses or resumes. Change them at chrome://extensions/shortcuts, or in Firefox under Manage Extension Shortcuts in about:addons.
  • Player: previous/next, play/pause, speed and stop. The page follows the spoken text; scroll away and the arrow button brings you back.
  • Click any sentence while reading to jump to it.
  • Google Docs are read from their plain-text export, without highlighting.

There are 41 voices in American and British English, Spanish, French, Hindi, Italian and Brazilian Portuguese.