man(1)

✨ NAME ✨

okay so bestie, meet gtts-cli — a lil command line bestie that converts text to mp3 💖 this page is man(1), and it's about to be your new favorite thing, no cap.

---

🌸 SYNOPSIS 🌸

gtts-cli [-h | --help] (["text to speak"] | -f FILE | --file FILE) [-o
DESTINATION_FILE | --destination DESTINATION_FILE] [-l LANG | --lang
LANG] [--slow] [--debug]

---

🎀 DESCRIPTION 🎀

So basically, gtts-cli is the command line utility that takes your text and makes an mp3 file out of it. It literally lets you speak unlimited lengths of text, because the way it does that is by tokenizing long sentences right at the spots where speech would naturally pause. it's giving "I got you" energy fr fr ✨

---

💅 OPTIONS 💅

• -h, --help — prints a help message and then dips out (exits). iconic behavior tbh.
• "text to speak", -f FILE, --file FILE — pick your vibe: if you give it text in quotes, it generates an mp3 with that text spoken. If you use -f FILE, it generates the mp3 with the text from FILE instead. either way, you're getting audio 🫶
• -o DESTINATION_FILE, --destination DESTINATION_FILE — this is the file the generated mp3 gets written to. and if you don't give one? it writes to stdout instead. > bestie… that is probably not what you want! 😭
• -l LANG, --lang LANG — which language the given text gets spoken in. here are all the supported languages, and yes there are a lot, she's multilingual and that's the point 👑
  • 'af' : 'Afrikaans'
  • 'sq' : 'Albanian'
  • 'ar' : 'Arabic'
  • 'hy' : 'Armenian'
  • 'bn' : 'Bengali'
  • 'ca' : 'Catalan'
  • 'zh' : 'Chinese'
  • 'zh-cn' : 'Chinese (Mandarin/China)'
  • 'zh-tw' : 'Chinese (Mandarin/Taiwan)'
  • 'zh-yue' : 'Chinese (Cantonese)'
  • 'hr' : 'Croatian'
  • 'cs' : 'Czech'
  • 'da' : 'Danish'
  • 'nl' : 'Dutch'
  • 'en' : 'English'
  • 'en-au' : 'English (Australia)'
  • 'en-uk' : 'English (United Kingdom)'
  • 'en-us' : 'English (United States)'
  • 'eo' : 'Esperanto'
  • 'fi' : 'Finnish'
  • 'fr' : 'French'
  • 'de' : 'German'
  • 'el' : 'Greek'
  • 'hi' : 'Hindi'
  • 'hu' : 'Hungarian'
  • 'is' : 'Icelandic'
  • 'id' : 'Indonesian'
  • 'it' : 'Italian'
  • 'ja' : 'Japanese'
  • 'km' : 'Khmer (Cambodian)'
  • 'ko' : 'Korean'
  • 'la' : 'Latin'
  • 'lv' : 'Latvian'
  • 'mk' : 'Macedonian'
  • 'no' : 'Norwegian'
  • 'pl' : 'Polish'
  • 'pt' : 'Portuguese'
  • 'ro' : 'Romanian'
  • 'ru' : 'Russian'
  • 'sr' : 'Serbian'
  • 'si' : 'Sinhala'
  • 'sk' : 'Slovak'
  • 'es' : 'Spanish'
  • 'es-es' : 'Spanish (Spain)'
  • 'es-us' : 'Spanish (United States)'
  • 'sw' : 'Swahili'
  • 'sv' : 'Swedish'
  • 'ta' : 'Tamil'
  • 'th' : 'Thai'
  • 'tr' : 'Turkish'
  • 'uk' : 'Ukrainian'
  • 'vi' : 'Vietnamese'
  • 'cy' : 'Welsh'
• --slow — slower read speed for the text. for when you want it to take its sweet time 🐢
• --debug — prints debug statements. perfect for when you need to know what's going on behind the scenes 🔍

---

🌈 EXAMPLES 🌈

Read the string 'Hello' in English to hello.mp3

gtts-cli "Hello" -l 'en' -o hello.mp3

Read the string 'Hello' in English (slow speed) to hello.mp3

gtts-cli "Hello" -l 'en' -o hello.mp3 --slow

Read the contents of file 'hello.txt' in Czech to hello.mp3:

gtts-cli -f hello.txt -l 'cs' -o hello.mp3

Read the string 'Hello' from stdin in English to hello.mp3

echo "Hello" | gtts-cli -l 'en' -o hello.mp3 -

---

🦋 SEE ALSO 🦋

ngl bestie… this section is literally empty. nothing to see here. moving on 💀

---

🐛 BUGS 🐛

No known bugs. she's flawless, your honor. periodt. ✨

---

👑 AUTHOR 👑

Ethan Ward <ethan.ward@mycroft.ai> — the icon, the legend, the one who made this whole thing happen 🫶

---

and that's the whole page, bestie! this was version 1.2.0, dated 04 August 2017, and it's the gtts-cli manpage, man(1) — so go forth and make some mp3s, you absolute main character 💖🌸🦋