semvec/pypi-packages huggingface dataset:
readthis 0.1.1
readthis - A command line tool to read a text file aloud
License: MIT

# Readthis

Readthis is a command line tool that reads aloud a given text file using the gTTS (Google Text-to-Speech) interface.

## Usage

```bash
$ readthis [OPTIONS] FILE
```

### Positional Arguments

- `FILE`: The file to read aloud. Use - to read from stdin.

### Options

- `-h, --help`: Show the help message and exit.
- `--lang LANG, -l LANG`: Choose the language to use for reading. Specify the language using the language code (e.g., fr for French). Defaults to English.
- `--url, -u`: fetch an URL instead of a file

## Installation

```bash
$ pip install readthis
```

## Examples

- Read a text file named sample.txt in English:

```bash
$ readthis --lang en sample.txt
```

- Read from stdin in French:
```bash
$ echo "Bonjour, comment ça va ?" | readthis -l fr
```

- Fetch and read an article:
```bash
$ readthis -u https://example.com
```

## License

This project is licensed under the [MIT License](./LICENCE).