text2speak

text2speak CLI tool. Drop text files into input/, run t2s speak, get audio in output/. Powered by OpenAI TTS.

Installation

pnpm add -g text2speak

Requirements

• Node.js 22+
• OpenAI API key

Configuration

Create ~/.text2speak/.env and add your API key:

OPENAI_API_KEY=your-key-here

Set default voice:

t2s config set voice nova

How It Works

1. Put any .txt file in input/
2. Run t2s speak
3. Audio appears in output/

Usage

Speak

t2s speak

Processes all .txt files in input/, writes audio to output/.

$ t2s speak input/hello.txt
Speaking 1 file(s)...
  hello.txt - generating...
  ✓ output/hello.mp3 [39c2d44f]

Done.

Speak a single file:

t2s speak path/to/file.txt

Options

| Command | Flag | Description | Default | |---------|------|-------------|---------| | t2s speak --voice nova | --voice <name> | Voice character: alloy, echo, fable, onyx, nova, shimmer | alloy | | t2s speak --model tts-1-hd | --model <name> | tts-1 is fast, tts-1-hd is higher quality | tts-1 | | t2s speak --format wav | --format <fmt> | Audio output format: mp3, opus, wav, flac | mp3 | | t2s speak --speed 1.25 | --speed <n> | Playback speed multiplier: 0.25 (slowest) to 4.0 (fastest) | 1.0 | | t2s speak --provider openai | --provider <name> | TTS provider to use | openai | | t2s speak --out my-audio.mp3 / --out audio/ | --out <path> | Output file path or directory | output/ ||

Translation

t2s speak --translate en
t2s speak --translate fi
t2s speak --translate sv

--translate en translates the input text to English before generating audio.

--translate <other> translates to any supported language, then generates audio.

Translation requires OpenAI provider.

Example — Finnish text to English audio:

$ t2s speak input/finnish.txt --translate en
Speaking 1 file(s)...
  finnish.txt - generating...
  ↳ translated text: output/finnish.txt
  finnish.txt - speaking...
  ✓ output/finnish.mp3 [94cb030d]

Done.

Translated text output:

Good day. This is a Finnish test file. Welcome to use the text2speak tool.

Manage history

t2s list
t2s show <id>
t2s export <id>
t2s delete <id>
t2s delete --all

Database

t2s db stats
t2s db list
t2s delete --all

t2s db stats shows generation count, database file size, and oldest/newest dates.

t2s db list shows each source file that has been spoken, with generation count and last spoken date.

t2s delete --all removes all stored generations.

List voices

t2s voices

List supported languages

t2s languages

Output Formats

| Format | Description | |--------|-------------| | mp3 | MP3 (default) | | opus | Opus | | wav | WAV | | flac | FLAC |

Providers

| Provider | Flag | Notes | |----------|------|-------| | OpenAI TTS | --provider openai | Default. Models: tts-1, tts-1-hd |

Voices

Run t2s voices to list available voices for the configured provider.

Storage

History is stored locally in SQLite:

• macOS/Linux: ~/.text2speak/history.db
• macOS/Linux config: ~/.text2speak/.env

Supported Languages

99 languages supported for --translate. Use the code with --translate.

| Code | Language | Code | Language | Code | Language | |------|----------|------|----------|------|----------| | af | Afrikaans | hi | Hindi | pt | Portuguese | | am | Amharic | hr | Croatian | ro | Romanian | | ar | Arabic | ht | Haitian Creole | ru | Russian | | as | Assamese | hu | Hungarian | sa | Sanskrit | | az | Azerbaijani | haw | Hawaiian | sd | Sindhi | | ba | Bashkir | hy | Armenian | si | Sinhala | | be | Belarusian | id | Indonesian | sk | Slovak | | bg | Bulgarian | is | Icelandic | sl | Slovenian | | bn | Bengali | it | Italian | sn | Shona | | bo | Tibetan | ja | Japanese | so | Somali | | br | Breton | jw | Javanese | sq | Albanian | | bs | Bosnian | ka | Georgian | sr | Serbian | | ca | Catalan | kk | Kazakh | su | Sundanese | | cs | Czech | km | Khmer | sv | Swedish | | cy | Welsh | kn | Kannada | sw | Swahili | | da | Danish | ko | Korean | ta | Tamil | | de | German | la | Latin | te | Telugu | | el | Greek | lb | Luxembourgish | tg | Tajik | | en | English | ln | Lingala | th | Thai | | es | Spanish | lo | Lao | tk | Turkmen | | et | Estonian | lt | Lithuanian | tl | Tagalog | | eu | Basque | lv | Latvian | tr | Turkish | | fa | Persian | mg | Malagasy | tt | Tatar | | fi | Finnish | mi | Maori | uk | Ukrainian | | fo | Faroese | mk | Macedonian | ur | Urdu | | fr | French | ml | Malayalam | uz | Uzbek | | gl | Galician | mn | Mongolian | vi | Vietnamese | | gu | Gujarati | mr | Marathi | yi | Yiddish | | ha | Hausa | ms | Malay | yo | Yoruba | | he | Hebrew | mt | Maltese | yue | Cantonese | | nn | Nynorsk | my | Myanmar | zh | Chinese | | no | Norwegian | ne | Nepali | | | | oc | Occitan | nl | Dutch | | | | pa | Punjabi | ps | Pashto | | |

Tech Stack

| Tool | Purpose | |------|---------| | TypeScript | Language | | Commander | CLI framework | | better-sqlite3 | Local history | | OpenAI TTS API | Speech generation | | Vitest | Testing | | Biome | Lint & format | | pnpm | Package manager |

License

MIT