Files
say.sh/README.md
jhechavarria 0181a38d06 README updated
2018-08-23 01:40:23 +02:00

131 lines
2.3 KiB
Markdown

# say.sh
This script enables any debian based GNU/Linux distribution to talk! Based on Google's text to speach Android application, it gives you a few commands to ease your TTS experience on Linux.
## Setup
### Prerequisites
Before installing the script, you will need to install a few dependencies:
- libttspico-utils
- sox
- dialog
- xsel
To install all of them at once type the following command:
```
sudo apt-get install libttspico-utils sox dialog xsel
```
**Warning:** As libttspico-utils is a non-free package, it may not be available in your default packqge repositories.
## Install
To start installing the script simply type:
```
. say.sh install
```
This will go through a few operations required for it to work properly:
- creating a /home/user/bin/say directory
- moving the script to newly created directory
- creating and setting config file within newly created directory
- adding an instruction to /gome/user/.bashrc file
- reloading .bashrc file
## Configuration
During setup a default configuration will be set. You still can change it using the **saycfg** command. This command takes 3 arguments: language, volume and speed.
Example:
This command sets language to US English, volume to 1.2 and speed to 0.8
```
saycfg en-US 1.2 0.8
```
The script supports over to 6 different languages. Volume variates from 0 to 2 and speed from 0.5 to 1.5.
### Available languages
**en-GB** British English
**en-US** US English
**fr-FR** French
**de-DE** Deutsch
**es-ES** Spanish
**it-IT** Italiam
## Commands
### say
Start text interpretation and reading.
#### Basic usage
```
say Hello World!
```
#### Live changing language
If default configuration language doesn't fit with given text, you can overwrite it in command call.
```
say it-IT Buongiorno a tutti!
```
#### Using standard input
```
echo "Salut tout le monde!" | say
```
Even using standard input, language can still be overwritten:
```
echo "I love this app!" | say en-GB
```
### saycfg
Set full configuration
```
saycfg es-ES 1 1
```
### saylng
Sets current language in configuration
```
saylng de-DE
```
### saylng
Sets current volume in configuration. Volume can be set from 0 up tu 2
```
sayvol 2
```
### saylng
Sets current speed in configuration. Speed can be set from 0.5 to 1.5
```
sayspd 1.2
```