{"slug": "kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally", "title": "Kokoro Read-Aloud – select text in any app, hear it read locally", "summary": "A new open-source tool called Kokoro Read-Aloud lets users select text in any app and press Ctrl+Alt+R to have a neural text-to-speech voice read it aloud locally, with the default CPU build a 0.2 GB download running Paradee-8M, an 8.5 MB copy of Kokoro-82M, without a GPU or PyTorch. On an i5-12400F the tool begins speaking about 30 ms after receiving text and synthesizes 50 to 70 times faster than playback, using 0.6 GB on disk and roughly 0.35–0.7 GB of RAM, while an optional NVIDIA GPU build adds Kokoro's 28 voices at about 4 GB download and 7 GB on disk. The tool runs on Linux (Omarchy, Fedora GNOME) and Windows 11, keeps text on the machine, and is English-only, with four voices on the CPU build.", "body_md": "**Select text in any app, press Ctrl+Alt+R, and a neural voice running on your\nown machine reads it aloud.**\n\nNo GPU needed: the default build is a 0.2 GB download that runs\n[Paradee-8M](https://github.com/sahilmahendrakar/paradee), an 8.5 MB copy of\n[Kokoro-82M](https://huggingface.co/hexgrad/Kokoro-82M), on the CPU. On an\ni5-12400F it starts speaking about 30 ms after it gets the text, and\nsynthesizes 50 to 70 times faster than it plays. With an NVIDIA GPU, the GPU build adds\nKokoro itself and its 28 voices. It runs on Linux (Omarchy, Fedora GNOME) and\nWindows 11, and your text never leaves the machine.\n\n[Install](#install) • [Usage](#usage) • [Settings](#settings) •\n[Troubleshooting](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/troubleshooting.md) •\n[Report a bug](https://github.com/sayed-qutob-work/kokoro-read-aloud/issues/new?template=bug_report.yml)\n\n- **Light.** 0.2 GB to download, 0.6 GB on disk, about 0.35–0.7 GB of RAM\nwhile it runs, and no PyTorch. Four voices; the GPU build has 28.\n- **Fast listening that stays clear.** Listen at up to 3× with the voice's\npitch kept, and see the fastest speed your machine keeps up with.\n- **It shows where you are.** A caption strip shows the sentence being read,\nwhatever app the text came from.\n- **The VRAM back when you need it.** With the GPU build on Omarchy, the bar\nswitches between Kokoro on the GPU, Paradee on the CPU and off, so a game\nor a local LLM can have the GPU.\n- **Pinned and offline.** Packages and model files are pinned to tested\nversions and hashes, and on Linux the server makes no network connection\nafter setup.\n- **Windows 11 support.** The same server, hotkeys and settings as on Linux.\nRetested 2026-10-19 in a VM without a GPU, before the CPU build became\nParadee; the new CPU build is not tested on Windows yet.\n\nThe details behind each of these are in\n[how it works](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/how-it-works.md).\n\n- **English only.** There are 28 American and British voices, four on the CPU. Other languages\nin the Latin alphabet get English pronunciation, and other scripts and emoji\nare skipped.\n- **Download size.** The CPU build downloads about 0.2 GB and takes about\n0.6 GB on disk. The GPU build, which adds Kokoro's 28 voices, downloads\nabout 4 GB and takes about 7 GB.\n- **The GPU build needs NVIDIA.** It is for Kokoro's 28 voices and its better\nsound, not for speed. Paradee's sound quality is slightly lower, most\nnoticeably on headphones, but on an i5-12400F it starts speaking as fast as\nthe GPU does ([measurements](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/how-it-works.md#cpu-or-gpu) ).\n- **No in-place highlighting on Linux,** only the caption strip.\n\n| Platform | Tested | \n|---|---|\n| Omarchy 4.0.4 (Hyprland), NVIDIA | Clean GPU install from this repository, 2026-10-18; the CPU build's packages and model installed and read aloud, 2026-11-01 | \n| Fedora 44 (GNOME), NVIDIA | Last run 2026-09-30; the installer not yet run there | \n| Windows 11 | Fresh install in a VM without a GPU, 2026-10-19, before the CPU build became Paradee; the GPU path last tested mid-August 2026 | \n\nOn Linux, one command, `kokoroctl setup`, installs everything without root,\noutside the code folder. Outside Omarchy it needs a few system packages first.\n\n## **Omarchy** (Hyprland)\n\n```\nomarchy plugin add https://github.com/sayed-qutob-work/kokoro-read-aloud --enable\n```\n\n1. Omarchy asks you to confirm, because plugins run unsandboxed in the shell. Then it asks which bar section to use.\n2. A Kokoro icon appears there, as five dim dots. Click it, and pick a build:\n**CPU** (about 0.2 GB, the default) or**GPU** (about 4 GB, NVIDIA only).\n3. A notification says when Kokoro is ready. Ctrl+Alt+R, T and S are bound for you.\n\nThe caption strip and the More settings window also need Tk, the one package a fresh Omarchy lacks. Reading works without it. To add them, any time:\n\n```\nsudo pacman -S --needed tk\n```\n\nTo set up from a terminal instead:\n\n```\n~/.config/omarchy/plugins/io.github.sayed-qutob-work.kokoro-read-aloud/linux/kokoroctl setup\n```\n\n## **Fedora** (GNOME)\n\n```\nsudo dnf install python3-tkinter python3-xlib portaudio wl-clipboard jq curl libnotify\ngit clone https://github.com/sayed-qutob-work/kokoro-read-aloud.git\ncd kokoro-read-aloud\nlinux/kokoroctl setup\n```\n\nSetup doesn't bind GNOME shortcuts; it prints the three commands. Bind\nthem in Settings > Keyboard > View and Customize Shortcuts > Custom Shortcuts.\n`kokoroctl setup` has not been run on Fedora yet; please\n[report](https://github.com/sayed-qutob-work/kokoro-read-aloud/issues/new?template=bug_report.yml)\nwhat happens.\n\n## **Windows 11** (retested 2026-10-19 in a VM, without a GPU)\n\nYou need [Python 3.12](https://www.python.org/downloads/) (exactly 3.12),\n[AutoHotkey v2](https://www.autohotkey.com/) and the\n[Visual C++ runtime](https://aka.ms/vs/17/release/vc_redist.x64.exe), which\nthe GPU build's torch needs and a fresh Windows lacks\n(`winget install Microsoft.VCRedist.2015+.x64`).\n\nIn PowerShell or Command Prompt:\n\n```\ngit clone https://github.com/sayed-qutob-work/kokoro-read-aloud.git\ncd kokoro-read-aloud\npy -3.12 -m venv env\nenv\\Scripts\\python.exe -m pip install -r requirements-cuda.txt\nenv\\Scripts\\python.exe tts_server.py\n```\n\nWithout an NVIDIA GPU, install `requirements.txt` instead of\n`requirements-cuda.txt`.\n\nWhen it prints `ready on http://127.0.0.1:5111`, start\n`read_aloud.ahk`. To start everything at login, put a shortcut to\n`start_tts.vbs` in `shell:startup`.\n\nWhat setup does, where the files go, and the Windows details are in\n[install.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/install.md).\n\n| Keys | Action | \n|---|---|\n| `Ctrl+Alt+R` | Read the selection | \n| `Ctrl+Alt+T` | Read the clipboard as-is | \n| `Ctrl+Alt+S` | Stop | \n\nThe hotkeys work wherever text can be selected, including terminals and\nPDFs. On Linux the selection is read without copying it. On Windows the\nhotkey copies it and then puts your clipboard back; Windows Terminal needs no\nsetting, and in VS Code's terminal you turn on\n[copy-on-select](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/install.md#optional-extras).\n\n- \n**The Omarchy bar icon:**\n  - left click opens the panel: GPU / CPU / Off, voice, speed, captions;\n  - right click turns the model off or on;\n  - middle click stops.\n See [omarchy.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/omarchy.md) .\n- \n**The caption strip** is off by default. Turn it on with Captions in the\nOmarchy panel, or with`systemctl --user enable --now kokoro-overlay` on\nany Linux ([options](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/settings.md#caption-strip) ).\n- \n**On Windows,** the spoken word is also tinted in the app itself: in\nFirefox, in Notepad, and in Chrome or Edge with the bundled extension\n([details](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/windows.md) ).\n- \n**From a terminal** on Linux,`kokoroctl` turns the model off and on,\nswitches GPU and CPU, and changes the voice and speed\n([reference](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/omarchy.md#kokoroctl) ).\n\n- **Your text stays on your machine.** The model runs locally, and the\nserver listens only on 127.0.0.1.\n- **No network after setup, on Linux.** The server loads the pinned model\nfiles from disk in Hugging Face's offline mode. It was tested with no\nnetwork at all. On Windows, see[install.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/install.md#windows) .\n- **Web pages can't use it.** The server refuses requests from browser tabs,\nincluding DNS rebinding, and accepts only JSON from local programs. Until\n2026-10-18 a web page could make it speak and read what it was reading:[the three attacks, measured before and after the fix](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/security.md) .\nAny program running as you can still use it, as with any local service.\n- **Other accounts can't use it, on Linux.** The server refuses programs\nof other users on the same computer, and the hotkey only sends text to a\nserver you run ([how](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/security.md#postscript-2026-11-14-other-accounts-on-the-same-machine) ).\n- **The clipboard is never polled.** On Linux the hotkey doesn't touch it at\nall.\n- **Pinned downloads.** Every package and every model file is checked\nagainst a pinned hash, and so is uv when setup downloads it.\n- **No root,** except for the system packages you install yourself.\n- **The Omarchy plugin runs unsandboxed** in the shell, like every Omarchy\nplugin.\n- **The logs stay local.**`read_aloud.log` keeps a short excerpt of each\nselection, for diagnosing wrong reads. On Linux only you can read them.\n\nThe Settings panel changes the voice, speed, pauses, output device and caption strip. It also shows the fastest speed your machine keeps up with. To open it:\n\n- **Windows:** the tray icon.\n- **Omarchy:** More settings, in the bar panel. The voice and speed are also\nright in the panel.\n- **GNOME:** \"Kokoro Settings\" in the app grid.\n\nSettings are saved in `settings.json` and survive a restart. The keys, all 28\nvoices with their grades, and the caption options are in\n[settings.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/settings.md).\n\n|  | Update | Uninstall | \n|---|---|---|\n| Omarchy | `omarchy plugin update io.github.sayed-qutob-work.kokoro-read-aloud` , then`omarchy restart shell` and`kokoroctl setup` | `kokoroctl uninstall` , then`omarchy plugin remove io.github.sayed-qutob-work.kokoro-read-aloud` | \n| Fedora | `git pull` , then`kokoroctl setup` | `kokoroctl uninstall` , remove the GNOME shortcuts, delete the folder | \n| Windows | `git pull` , the same`pip install -r` again, restart the server | [Three steps](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/install.md#removing) | \n\n`kokoroctl uninstall` asks before it does anything. It keeps your settings\nunless you pass `--purge`. More in [install.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/install.md#removing).\n\n- **Something failed:** read`server.log` first. On Linux,`kokoroctl log` opens it.\n- **Reads stall or stutter:** lower the reading speed until the panel's\nwarning clears, or use the GPU.\n- **\"Kokoro is off\" or \"still loading\":** turn it on from the bar, or with`kokoroctl cpu` (or`gpu` ). Loading takes 4–6 s.\n- **\"No matching distribution found for kokoro\" on Windows:** the venv isn't\nPython 3.12.\n\nMore cases, and what each log holds, are in\n[troubleshooting.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/troubleshooting.md).\n\nA Flask server on 127.0.0.1:5111 keeps the model loaded: Paradee-8M on the CPU, or Kokoro-82M on an NVIDIA GPU. The hotkey script sends it the text. The server splits it at commas and full stops, synthesizes ahead of playback, time-stretches without changing pitch, and plays it. The caption strip, the Windows highlighter and the bar widget only read the server's state.\n\nThe details are in [how-it-works.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/how-it-works.md). The measurements\nbehind this README, each with the machine it was taken on, are in\n[AUDIT.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/AUDIT.md), the project's engineering log.\n\nFrom each project's own README, October 2026.\n\n**Omarchy, with Kokoro:**\n\n- [Omatalk](https://github.com/zerobearing2/omatalk) : reads the selection on F8, with Kokoro on the CPU.\n- [Say It](https://github.com/txapotxapa/sayit-omarchy) : a bar player that highlights each word; 54 voices in nine languages.\n- [Read Aloud: Text to Speech](https://github.com/remigius-labs/omarchy-read-aloud) : reads the clipboard from the bar; 54 voices in nine languages.\n- [kokoro-tts-omarchy](https://github.com/MASH2RAFI/kokoro-tts-omarchy) : GPU builds for NVIDIA, AMD and Intel.\n- [omarchy-tts](https://github.com/jagrat7/omarchy-tts) : several local and cloud voice engines behind one key.\n- [omarchy-speak](https://github.com/seanpowless-dotcom/omarchy-speak) : Piper for speed, Kokoro for quality.\n- [Omarchy Talks](https://github.com/Zerolxgic/Omarchy-Talks) : reads the selection through VoiceBox.\n\n**Elsewhere:**\n\n- [Speech Note](https://github.com/mkiol/dsnote) : an offline Linux app for text-to-speech, speech-to-text and translation.\n- [Pied](https://github.com/Elleo/pied) : installs Piper voices for Speech Dispatcher, so other Linux apps can use them.\n- [kokoro-sapi](https://github.com/RvRooijen/kokoro-sapi) : Kokoro as a Windows SAPI voice, for apps that use system voices.\n- [TinyReadAloud](https://github.com/dorofino/TinyReadAloud) : a Windows tray app that reads the selection on Ctrl+Alt+R.\n- [Read Aloud](https://github.com/ken107/read-aloud) : a browser extension that reads web pages.\n- [Kokoro-FastAPI](https://github.com/remsky/Kokoro-FastAPI) : Kokoro behind an OpenAI-compatible speech API, in Docker.\n\nThe code here is MIT-licensed. It builds on, and redistributes none of:\n\n- [Kokoro-82M](https://huggingface.co/hexgrad/Kokoro-82M) and[kokoro](https://github.com/hexgrad/kokoro) by hexgrad (Apache-2.0);\n- [Paradee-8M](https://github.com/sahilmahendrakar/paradee) by\nsahilmahendrakar (Apache-2.0), the CPU voice;\n- PyTorch;\n- eSpeak NG (GPL-3.0);\n- and more.\n\nThe full list, and what redistributing a bundle would require, is in\n[licenses.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/licenses.md). This project is not affiliated with hexgrad\nor the Kokoro project.\n\nBug reports and ideas welcome via\n[issues](https://github.com/sayed-qutob-work/kokoro-read-aloud/issues/new/choose).\nFor pull requests, please open an issue first.\n\n- **Bugs:** the[bug report form](https://github.com/sayed-qutob-work/kokoro-read-aloud/issues/new?template=bug_report.yml) asks for your platform,`kokoroctl status` and the logs.\n- **Security problems:** please report them privately, as described in[SECURITY.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/SECURITY.md) .\n- **Before changing code,** read[docs/README.md](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/docs/README.md) . The\nengineering docs record what was measured, and what was tried and\nrejected.\n\nMIT, see [LICENSE](https://github.com/sayed-qutob-work/kokoro-read-aloud/blob/main/LICENSE).", "url": "https://wpnews.pro/news/kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally", "canonical_source": "https://github.com/sayed-qutob-work/kokoro-read-aloud", "published_at": "2026-11-20 21:15:10+00:00", "updated_at": "2026-11-20 21:44:09.318569+00:00", "lang": "en", "topics": ["ai-tools", "artificial-intelligence", "natural-language-processing"], "entities": ["Kokoro Read-Aloud", "Paradee-8M", "Kokoro-82M", "Omarchy", "Fedora GNOME", "Windows 11", "NVIDIA", "Hyprland"], "also_reported_by": [], "takeaway": "The default CPU build runs Paradee-8M, an 8.5 MB copy of Kokoro-82M, with no GPU or PyTorch, starting speech about 30 ms after text arrives and synthesizing 50–70× faster than playback on an i5-12400F.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally", "markdown": "https://wpnews.pro/news/kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally.md", "text": "https://wpnews.pro/news/kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally.txt", "jsonld": "https://wpnews.pro/news/kokoro-read-aloud-select-text-in-any-app-hear-it-read-locally.jsonld"}}