Skip to main content

Text-to-speech CLI with podcast feed publishing.

Project description

aloud

Text-to-speech CLI with podcast feed publishing. Uses Microsoft Edge TTS — free, no API key needed.

Install

pip install aloud

Or with uv:

uv tool install aloud

System dependencies

  • mpv — audio playback (sudo apt install mpv)
  • ffprobe — episode durations, publish mode only (sudo apt install ffmpeg)
  • git — feed publishing
  • xclip / xsel / wl-paste — clipboard reading

Usage

aloud article.txt              # play locally
aloud -c                       # read from clipboard
cat notes.md | aloud           # read from stdin
aloud -o article.txt           # publish to podcast feed
aloud -s "+80%" paper.md       # custom speed
aloud -v "en-US-JennyNeural"   # different voice

Subcommands

aloud feed                     # regenerate RSS feed and publish
aloud config                   # set up feed directory, URL, defaults

Playback controls

Space = pause, Left/Right = skip 5s, q = quit

Configuration

Run aloud config to set up:

Feed directory [~/Projects/read-aloud-feed]:
Feed URL [https://...]:
Default speed [+20%]:

Config is stored in ~/.config/aloud/config.json.

License

GPL-3.0-or-later

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aloud-0.1.0-py3-none-any.whl (8.4 kB view details)

Uploaded Python 3

File details

Details for the file aloud-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: aloud-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for aloud-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 959bdcabb357380b1330cd268692af14b4feec5410d63489413fd4ef042acb3e
MD5 8bcfc9dc2486f7f4f9700386b869578e
BLAKE2b-256 f64368f02a0d61157e836fd666d6e608b9d4e8c6e8cb32951d0e76b74983b081

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page