Metadata-Version: 2.4
Name: aloud
Version: 0.1.0
Summary: Text-to-speech CLI with podcast feed publishing.
Project-URL: Homepage, https://github.com/xuefei-wang/aloud
Project-URL: Repository, https://github.com/xuefei-wang/aloud
Project-URL: Issues, https://github.com/xuefei-wang/aloud/issues
Author: Xuefei Wang
License-Expression: GPL-3.0-or-later
Keywords: cli,edge-tts,podcast,text-to-speech,tts
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.10
Requires-Dist: edge-tts>=6.1
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# aloud

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

## Install

```bash
pip install aloud
```

Or with uv:

```bash
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

```bash
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

```bash
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
