toilet(1)

💖 TOIlet — toilet(1) 💖

okay so welcome to the toilet(1) page from the General Commands Manual 🫶 this is literally your guide to making big colourful letters, and yes, we're gonna slay it.

---

🌸 NAME 🌸

TOIlet — display large colourful characters ✨

🦋 SYNOPSIS 🦋

       toilet [ -hkostvSW ] [ -d fontdirectory ]
              [ -f fontfile ] [ -F filter ] [ -w outputwidth ]
              [ -I infocode ] [ -E format ] [ message ]

💅 DESCRIPTION 💅

okay so TOIlet prints text using large characters made of smaller characters. It is similar in many ways to FIGlet with additional features such as Unicode handling, colour fonts, filters and various export formats. it's giving glow-up, no cap ✨

🎀 USAGE 🎀

TOIlet either reads its input from the command line or from the standard input 🫶

✨ OPTIONS ✨

• -f, --font <name> — use the given font instead of the default value. Fonts are .flf or .tlf files stored in the /usr/share/figlet directory. Fonts are looked first in the font directory, then in the current directory. There is also a special built-in font called term that serves as a fallback if no font is available 🔤
• -d, --directory <dir> — specify the directory in which to look for fonts. The default value is set at build time and usually defaults to /usr/share/figlet 📁
• -s — default behaviour: uses the font's smushing information if any, otherwise forces overlapping, or does nothing if the glyph only has one subcharacter 💅
• -S — sets smushing (nicely merging glyphs) 💞
• -k — sets kerning (rendering subcharacters as close to each other as possible) 🤏
• -W — renders characters at their full width 🫰
• -o — sets overlapping (glyphs slightly overlap the previous one) 🫂
• -w, --width <width> — set the output width. By default, TOIlet will wrap its output at 80 character columns 📏
• -t, --termwidth — set the output width to the terminal width 🖥️
• -F, --filter <filters> — specify a list of filters to be applied to the output. <filters> is a colon-separated list of filters such as crop:rotate:rainbow 💫
• -F, --filter list — the special argument list outputs a list of available filters 📋
• --rainbow, --metal — shortcuts to commonly used filters that are guaranteed to exist 🌈
• -E, --export <format> — specify the output format. By default, TOIlet will output UTF-8 text using ANSI colour codes suitable for most terminals such as XTerm or rxvt. <format> is the name of the export format as recognised by libcaca 🎨
• -E, --export list — the special argument list outputs a list of available export formats 📋
• --irc, --html — shortcuts to commonly used export formats that are guaranteed to exist 🌐
• -h, --help — display a short help message and exit 🆘
• -I, --infocode <code> — print a FIGlet infocode. This flag is only here for FIGlet compatibility, see the figlet manpage for more information about it 🔎
• -v, --version — output version information and exit 🏷️

also bestie: several -F flags can also be specified on the command line, in which case filters will be applied in order of appearance 🫶

🌈 EXAMPLES 🌈

toilet Hello World

toilet Hello | toilet

tail -f /var/log/messages | toilet -f term --rainbow

💀 BUGS 💀

real talk 😭: FIGlet compatibility is not complete yet.

👑 AUTHOR 👑

TOIlet and this manual page were written by Sam Hocevar <sam@hocevar.net>. There is a webpage available at http://caca.zoy.org/wiki/toilet .

🦋 SEE ALSO 🦋

go check out figlet(6) 👀

---

mwah 💋 this page comes from libcaca @PACKAGE_VERSION@ and is dated 2006-11-10; it's the toilet(1) page — bye bestie 🫶