NUM2WORDS(1)

💖 num2words(1) 💖

okay so bestie, welcome to the num2words manual page — it lives in section 1 of the User Commands manual, and it is exactly as chaotic as it sounds. sit down, grab a strawberry 🍓, we're converting numbers into words.

---

✨ NAME ✨

num2words — num2words. that's it. that's the name section. iconic brevity, no notes. 💅

---

🌸 DESCRIPTION 🌸

so here's the thing. before this program even gets to do its little job, Python pops off with a whole stack of SyntaxWarnings from a file called docopt.py living at /usr/lib/python3.14/site-packages/. it's giving "the compiler is yelling at you but everything still works" energy. these are warnings, not errors — but read them, because the page says the escape sequences will not work in the future. 🙈

here's the whole meltdown, verbatim, exactly like your terminal will spit it at you:

/usr/lib/python3.14/site-packages/docopt.py:165: SyntaxWarning: "\S" is an
invalid escape sequence. Such sequences will not work in the future.
Did you mean "\\S"? A raw string is also an option.

       name = re.findall('(<\S*?>)', source)[0]

/usr/lib/python3.14/site-packages/docopt.py:166: SyntaxWarning: "\[" is an
invalid escape sequence. Such sequences will not work in the future.
Did you mean "\\["? A raw string is also an option.

       value = re.findall('\[default: (.*)\]', source, flags=re.I)

/usr/lib/python3.14/site-packages/docopt.py:207: SyntaxWarning: "\[" is an
invalid escape sequence. Such sequences will not work in the future.
Did you mean "\\["? A raw string is also an option.

       matched = re.findall('\[default: (.*)\]', description,
       flags=re.I)

/usr/lib/python3.14/site-packages/docopt.py:456: SyntaxWarning: "\S" is an
invalid escape sequence. Such sequences will not work in the future.
Did you mean "\\S"? A raw string is also an option.

       split = re.split('\n *(<\S+?>|-\S+?)', doc)[1:]

and after all that drama clears, the actual point of the program, lowkey understated:

num2words: convert numbers into words. ✨

📋 Usage:

num2words [options] <number> num2words --list-languages num2words
--list-converters num2words --help

🎀 Arguments:

• <number> — the number you want to convert into words. that's the whole job, bestie. hand it a number, get words back. 🫶

---

👑 OPTIONS 👑

every single one, no skips, we don't gatekeep here:

• -L, --list-languages — show all the languages. the full menu, bestie. 🌈
• -C, --list-converters — show all the converters. every flavor of number-to-word it can do. 🔥
• -l, --lang=<lang> — output language. default is en. 🇬🇧
• -t, --to=<to> — output converter. default is cardinal. 👑
• -h, --help — show this message. the classic. the icon. 🎀
• -v, --version — show version. 💅

---

🔥 EXAMPLES 🔥

not me showing you the receipts, but here, look:

$ num2words 10001

ten thousand and one

$ num2words 24,120.10

twenty-four thousand, one hundred and twenty point one

$ num2words 24,120.10 -l es

veinticuatro mil ciento veinte punto uno

$num2words 2.14 -l es --to currency dos euros con catorce
céntimos

(yes, that last one really is missing a space after the $ and really does run the output into the command — the manual said it, so we're saying it too. ate. 💀)

---

this entire page is num2words 0.5.14, dated September 2025 — so when you're out here flexing your number-to-words skills, that's the version you're flexing with. slay, go convert something, periodt. 💖✨🦋