PYFIGLET(1)

💖 PYFIGLET(1) — User Commands 💖

okay bestie, pull up a chair, because we're about to talk about pyfiglet, and she is iconic. this is section 1 of the manual (user commands, iykyk), and she's here to turn your boring little words into BIG GIANT ASCII ART WORDS. no cap. let's go ✨

✨ NAME ✨

pyfiglet — display text in large ASCII art fonts.

like... that's the whole job. that's the gig. she makes big letters out of small letters. main character energy fr fr 👑

🌸 SYNOPSIS 🌸

pyfiglet.py [options] text...

yeah that's it. options first, then the text you want her to glow up. the text... means you can pile on as many words as you want, she's not scared 🫶

🦋 DESCRIPTION 🦋

pyFIGlet</p> is a program that creates large characters out of ordinary screen characters. she takes ASCII text (that's your text) and renders it in ASCII art fonts. literally the glow-up pipeline. you put in plain text, she hands you back a whole mural 💅

and the tea on this specific version: this version of pyfiglet supports FIGlet fonts .flf and the FIGlet-compatible toilet-fonts .tlf. both. she's versatile like that. not everyone can do both but she can, and we love that for her 🌈

🎀 OPTIONS 🎀

the options section. the menu. the build-your-own-slay bar. every single one, no skips:

• --version — show the program's version number and then exit. she tells you who she is and dips. queen behaviour 👑
• -h, --help — show this help message and exit. the "wait what do I do" button, but make it helpful 💖
• -f FONT, --font=FONT — the font to render with. default is future. yes, the default font is literally named future, because she's always ahead of her time ⭐
• -D DIRECTION, --direction=DIRECTION — set the direction the text will be formatted in. default is auto. she'll figure out which way to go unless you tell her otherwise 🧚
• -j SIDE, --justify=SIDE — set justification. by default it just follows the print direction, so if you don't say anything she's not gonna stress about it 🌸
• -w COLS, --width=COLS — set the terminal width, used for wrapping and justification. default is 80. if your art is spilling out the sides, this is the dial you're turning 📏
• -r, --reverse — shows a mirror image of the output text. flip it. reflect it. it's giving mirror selfie 🪞
• -F, --flip — flips the rendered output text over. not a mirror — an actual flip, upside-down situation. chaos, but the cute kind 🙈

heads up bestie: -r and -F are two different transformations, so don't go thinking they're the same thing. one mirrors, one flips. she contains multitudes 💀

🌟 SEE ALSO 🌟

go say hi to her cousins, they're family:

• toilet(1)
• figlet(1)

and that's the whole page, periodt 🎀

this was pyfiglet 0.6, and she's been out here since June 2011 — so yes, she's been slaying since before some of y'all were born, and she's still eating every single time 💅✨ bye bestie, go make something big 🫶