Skip to main content

Speakly

A lightweight floating TTS mini-player for your desktop.

Speakly demo

Install

pipx install speakly

Or with Homebrew:

brew install noncuro/speakly/speakly

Quick Start

speakly "Hello, world!"           # uses free edge-tts, no API key needed
speakly                           # reads from clipboard
speakly --file article.txt        # reads from file
speakly --speed 2.0               # set playback speed

No API keys, no accounts, no configuration. It just works.

Features

  • Floating mini-player -- always-on-top window with play/pause, scrub, speed control (1x-3x), and volume
  • Free out of the box -- uses edge-tts (Microsoft Edge TTS), no API key required
  • Premium voice upgrades -- swap in OpenAI, ElevenLabs, or Inworld when you want better quality
  • Smart titles -- auto-generates a short title for the player window (Claude or GPT if configured, heuristic otherwise)
  • Audio caching -- SHA256-based cache in ~/.speakly/cache/ with 7-day TTL; repeated text plays instantly
  • Keyboard shortcut support -- wire up a system hotkey via macOS Shortcuts or Raycast
  • Catppuccin Mocha dark theme -- easy on the eyes at any hour

Providers

Provider Quality Speed Control API Key Best For
edge (default) Good Player only None needed Getting started, casual use
OpenAI Great Native 0.25-4x Required Speed range, consistent quality
ElevenLabs Excellent Player only Required Multilingual, natural voices
Inworld Excellent Player only Required High-quality at 2-3x speed

If you like listening at 2-3x speed, Inworld's TTS 1.5 Max model sounds excellent even sped up. Generation is fast and the audio quality is superb. Getting started takes a minute:

  1. Sign up at inworld.ai
  2. Grab your JWT key and secret from the dashboard
  3. Run speakly config to save your keys

Configuration

speakly config    # interactive setup -- set provider, speed, API keys

Config is saved to ~/.speakly/config.toml. API keys are stored securely in your system keychain via the keyring library.

You can also set environment variables directly:

export OPENAI_API_KEY=sk-...
export ELEVEN_API_KEY=...
export INWORLD_JWT_KEY=...
export INWORLD_JWT_SECRET=...

Usage

speakly [OPTIONS] [TEXT]

Options:
  -p, --provider  TTS provider: edge, openai, elevenlabs, inworld   [default: edge]
  -v, --voice     Voice name or ID
  -s, --speed     Playback speed multiplier                         [default: 1.0]
  -f, --file      Read text from a file
  --list-voices   List available voices for the provider
  --help          Show help

Commands:
  config          Open interactive configuration

Keyboard Shortcut (macOS)

Three steps to read any text with a hotkey:

  1. Download Speakly.shortcut from the latest release
  2. Double-click to import into Shortcuts
  3. Go to System Settings > Keyboard > Keyboard Shortcuts > Services and assign a hotkey (e.g., Cmd+Shift+S)

Then: select text anywhere, copy it (Cmd+C), press your shortcut -- Speakly reads it aloud.

Some apps that support macOS accessibility services (Safari, Notes, TextEdit, VS Code) let the shortcut grab selected text directly, skipping the copy step.

How It Works

Text goes to edge-tts (or your chosen provider), comes back as MP3, and gets cached in ~/.speakly/cache/. The player window appears instantly in a loading state while TTS generates in the background. On a cache hit, playback starts immediately with no waiting.

Long text is automatically chunked and concatenated so there is no input length limit.

Contributing

git clone https://github.com/noncuro/speakly.git
cd speakly
uv sync
uv run speakly "test"

Fork it, branch it, send a PR. All contributions welcome.

License

MIT

Metadata

Release files for speakly 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for speakly 0.1.0
File Size Uploaded Provenance Actions
speakly-0.1.0.tar.gz 479.2 kB With provenance Details for speakly-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for speakly 0.1.0
File Interpreter ABI Platform Actions
speakly-0.1.0-py3-none-any.whl Python 3 none any Details for speakly-0.1.0-py3-none-any.whl

Total release size: 500.0 kB

Release files / speakly-0.1.0.tar.gz

Download URL speakly-0.1.0.tar.gz
Size 479.2 kB
Tags Source
SHA-256 checksum
How to use checksums
46a85ab7c5d48bad727b349e92009ec9472fc72360769f7946cd033db6168e90
BLAKE2b-256 checksum
How to use checksums
97711442b5bc3b7b254c06b5c7ebd2e903f6736518e79cfa1be9a1fc8c508816
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 2, 2026.

Transparency log

Release files / speakly-0.1.0-py3-none-any.whl

Download URL speakly-0.1.0-py3-none-any.whl
Size 20.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b03ae873e1e5d6baa7cb4976f691f356a4145538276325ad341b06304a668266
BLAKE2b-256 checksum
How to use checksums
04914112922ca137d2079ef52ed250f473c292f6bae1a3e92de01c163001809e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 2, 2026.

Transparency log

Security for speakly 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for speakly-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page